A collector community platform for waffles, auctions, direct sales, and a community board that doubles as marketplace advertising.
- Next.js 16 (App Router)
- Supabase (Auth, Postgres, Storage, Realtime)
- Tailwind CSS
Use your own Supabase account (this repo is not tied to any connected Cursor MCP project).
- Go to supabase.com/dashboard
- Create a new project
- Open Project Settings → API and copy:
- Project URL
anonpublic key
Open SQL Editor in Supabase and run the full contents of:
supabase/migrations/20250618163000_initial_schema.sql
supabase/migrations/20250618170000_member_verification.sql
That creates:
- Profiles with social + payment handles
- Community board posts (including listing promos)
- Waffles, auctions, direct sales, flags
- Row Level Security policies
listing-imagesstorage bucket
In Supabase Authentication → URL Configuration:
- Set Site URL to your dev URL, e.g.
http://localhost:3001 - Add Redirect URLs (include every port you use locally):
http://localhost:3000/**http://localhost:3001/**http://localhost:3001/auth/callback
In Authentication → Providers → Email:
- For local dev, consider disabling Confirm email so signup goes straight to onboarding
Set the same port in .env.local:
NEXT_PUBLIC_SITE_URL=http://localhost:3001Copy the example env file and fill in your project values:
cp .env.example .env.localNEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-keyUse the Project URL without a trailing slash (the app strips one automatically, but best to omit it).
For manual member verification:
ADMIN_EMAILS=you@example.com
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
GMAIL_USER=you@gmail.com
GMAIL_APP_PASSWORD=your-16-char-app-passwordCreate a Gmail App Password at Google Account → Security → App passwords (requires 2-Step Verification). Paste it with or without spaces — both work.
Approve pending members at /admin/verifications. Approved members receive an email from your Gmail (or a console log if Gmail env vars are not set).
npm install
npm run devOpen http://localhost:3000.
- Auth + manually verified social-linked profiles
- Community board (discussion + listing promos)
- Waffles (free to host)
- Auctions (free to host in v1)
- Direct sales (free)
- Off-platform payments + flagging
- Token economy (thank-you tokens, purchased tokens, auction host fees)
src/
app/ Next.js routes
components/ Shared UI
lib/supabase/ Browser + server Supabase clients
types/database.ts Hand-written DB types for v1 schema
supabase/
migrations/ SQL migrations to run in Supabase
- Payments stay off-platform. Hosts display Venmo/PayPal/CashApp on their profile.
- Use donation language for waffles, not purchase language.
- After the migration runs, regenerate types anytime with the Supabase CLI if you link the project locally.