Skip to content

About

Collector community platform for waffles, auctions, direct sales, and community board

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FB Collector

A collector community platform for waffles, auctions, direct sales, and a community board that doubles as marketplace advertising.

Stack

  • Next.js 16 (App Router)
  • Supabase (Auth, Postgres, Storage, Realtime)
  • Tailwind CSS

Setup

1. Create a Supabase project

Use your own Supabase account (this repo is not tied to any connected Cursor MCP project).

  1. Go to supabase.com/dashboard
  2. Create a new project
  3. Open Project Settings → API and copy:
    • Project URL
    • anon public key

2. Run the database migration

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-images storage bucket

3. Configure auth (recommended)

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:3001

4. Environment variables

Copy the example env file and fill in your project values:

cp .env.example .env.local
NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

Use 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-password

Create 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).

5. Run locally

npm install
npm run dev

Open http://localhost:3000.

v1 scope

  • 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

v2 (later)

  • Token economy (thank-you tokens, purchased tokens, auction host fees)

Project structure

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

Notes

  • 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.

About

Collector community platform for waffles, auctions, direct sales, and community board

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages