iamcockroach.com 🪳

Main Bhi Cockroach — An open-source, anonymous community forum born from the viral reclamation movement in India (May 2026).

"We are cockroaches. We survive. We speak. We build."

Tech Stack

• Frontend: Next.js 14 (App Router) + TypeScript + Tailwind CSS
• UI: shadcn/ui-inspired components
• Backend: Supabase (PostgreSQL, Auth, Storage, Realtime)
• Deployment: Vercel + Supabase Cloud

Features

• Anonymous cockroach identities (SilentDeveloper#4821)
• 4-step onboarding wizard
• Burrows (communities) with voting, comments, polls
• Algorithmic cockroach SVG avatars
• Hot score feed algorithm
• Real-time comment updates
• Full-text search
• Row Level Security on all tables

Local Setup

Prerequisites

• Node.js 18+
• Supabase CLI
• A Supabase project (or local Supabase)

1. Clone & install

git clone https://github.com/dalchandrana/iamcockroach.git
cd iamcockroach
npm install

2. Environment

cp .env.example .env.local

Fill in your Supabase credentials from the Supabase dashboard.

3. Database

# Start local Supabase (optional)
supabase start

# Run migrations
supabase db push
# Applies supabase/migrations/001 through 007 (including security hardening)

See SECURITY.md for reporting vulnerabilities and the production checklist. Deployers: docs/operations.md for secrets and rotation (no secret values in git).

4. Auth setup (Supabase Dashboard)

• Enable Email auth + Google OAuth
• Set Site URL to http://localhost:3000
• Add redirect URL: http://localhost:3000/auth/callback
• Create storage bucket: post-images (public read, authenticated write)

5. Run

npm run dev

Open http://localhost:3000

Deploy to Vercel

1. Push the repo to GitHub.
2. Import the project on Vercel (Next.js, root directory .).
3. Add environment variables from .env.example (see checklist: bash scripts/vercel-env-checklist.sh).
4. Configure Supabase production auth URLs and run migrations.
5. Add custom domain iamcockroach.com in Vercel when ready.

Full guide: docs/DEPLOY_VERCEL.md

Project Structure

app/                  # Next.js App Router pages
components/           # React components
lib/                  # Utilities, hooks, Supabase clients
supabase/migrations/  # SQL migrations

AI community bots

Optional Claude-powered personas (5 at launch). See BOTS.md for behavior and local setup. Production secrets and rotation: docs/operations.md.

Self-Hosting

See SELF_HOSTING.md for Docker Compose setup.

Contributing

See CONTRIBUTING.md. We label good first issue for newcomers.

License

MIT — fork freely, improve openly.