pnpm install

1. Go to supabase.com
2. Click "New Project"
3. Fill in project details
4. Save your database password
5. Wait for project to initialize (~2 minutes)

1. Go to SQL Editor in Supabase Dashboard
2. Copy contents of supabase/migrations/001_initial_schema.sql
3. Paste and run
4. Copy contents of supabase/migrations/002_rls_policies.sql
5. Paste and run

1. Go to Storage in Supabase Dashboard
2. Click "New Bucket"
3. Name: shop-images
4. Public: Yes
5. File size limit: 5MB
6. Allowed MIME types: image/jpeg, image/png, image/webp

1. Go to Authentication > Providers
2. Enable Email provider
3. Disable "Confirm email" (for easier testing)
4. Set Site URL to http://localhost:3000
5. Add redirect URL: http://localhost:3000/api/auth/callback

1. Go to developer.here.com
2. Sign up for free account
3. Create new project
4. Generate REST API key
5. Copy the API key

1. Go to valueserp.com
2. Sign up for account
3. Get API key from dashboard

cp .env.example .env.local

Edit .env.local:

# Get these from Supabase Dashboard > Settings > API
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key_here
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key_here

# Get from HERE.com developer portal
HERE_API_KEY=your_here_api_key_here

# Optional: Get from ValueSERP
VALUESERP_API_KEY=your_valueserp_key_here

# Local development
NEXT_PUBLIC_SITE_URL=http://localhost:3000
NODE_ENV=development

pnpm dev

Open http://localhost:3000

1. Visit http://localhost:3000/auth/login
2. Enter your email
3. Check email for magic link
4. Click the link to login
5. In Supabase Dashboard > Table Editor > profiles
6. Find your user and set is_admin = true

1. Browse Shops: Visit homepage to see map
2. Submit Shop: Click "Submit Shop" and fill form
3. Review Submission: Login as admin, go to /admin
4. Approve Shop: Review and approve your test submission
5. View Shop: See it appear on the map!

# Development
pnpm dev          # Start dev server (http://localhost:3000)
pnpm build        # Build for production
pnpm start        # Start production server
pnpm lint         # Run ESLint

# Supabase (if using local development)
pnpx supabase start      # Start local Supabase
pnpx supabase stop       # Stop local Supabase
pnpx supabase db push    # Push migrations to remote
pnpx supabase db pull    # Pull schema from remote
pnpx supabase db reset   # Reset local database

1. Install Railway CLI

   npm i -g @railway/cli

2. Login to Railway

   railway login

3. Create New Project

   railway init

4. Add Environment Variables

   railway variables set NEXT_PUBLIC_SUPABASE_URL=your_url
   railway variables set NEXT_PUBLIC_SUPABASE_ANON_KEY=your_key
   railway variables set SUPABASE_SERVICE_ROLE_KEY=your_key
   railway variables set HERE_API_KEY=your_key
   railway variables set NEXT_PUBLIC_SITE_URL=https://your-app.railway.app

5. Deploy

   railway up

The railway.toml file is already configured!

1. Install Vercel CLI

   npm i -g vercel

2. Deploy

   vercel

3. Add Environment Variables

   • Go to Vercel Dashboard
   • Project Settings > Environment Variables
   • Add all variables from .env.example

• Check that Leaflet CSS is imported in globals.css
• Verify the component is using dynamic import with ssr: false
• Check browser console for errors

• Verify HERE_API_KEY is set correctly
• Check API key has geocoding permissions
• Look for CORS errors in console

• Verify storage bucket shop-images exists
• Check bucket is set to public
• Verify file size is under 5MB
• Check allowed MIME types

• Verify Supabase Auth is enabled
• Check redirect URLs are configured
• Ensure Site URL matches your domain
• Check email provider is enabled

• Verify migrations ran successfully
• Check RLS policies are enabled
• Ensure user has proper permissions
• Check Supabase logs for details

• Supabase Dashboard > Table Editor
• Or use SQL Editor for queries

pnpx supabase db dump -f backup.sql

pnpx supabase db reset

• Environment variables not committed to git
• RLS policies enabled on all tables
• Service role key kept secret
• File upload size limits enforced
• Rate limiting configured (production)
• CORS properly configured
• Admin routes protected

• Supabase Dashboard > Logs
• Railway Dashboard > Metrics
• Browser DevTools > Network/Console

• Supabase Dashboard > Database > Query Performance
• Check slow queries
• Monitor connection pool

Edit tailwind.config.ts and public/manifest.json

Edit CRYPTO_OPTIONS in src/app/shops/submit/page.tsx

Change TileLayer URL in src/components/Map/ShopMap.tsx

• Next.js Documentation
• Supabase Documentation
• Leaflet Documentation
• HERE.com API Docs
• Tailwind CSS

• Check GitHub Issues
• Review Documentation
• Join our community discussions

Happy coding! ☕️₿