FoundersCode

A social platform for founders building in public. Track your coding progress via CLI, share updates, and connect with other builders.

Live at founderscode.dev

Current Status: Live in Production

What's Working

• Landing page (/) - Signup page shown until 100 users
• Community feed - Real activity stream from database
• Private dashboard (/dashboard) - Manage projects, milestones, view activity
• Public profiles (/[username]) - Real stats, projects, milestones, streak
• CLI authentication (fcode login) - Browser-based auth flow
• CLI push (fcode push) - Log commits to your streak
• Email auth - Signup, login, password reset with email confirmation
• Mailgun SMTP - Production email delivery configured
• Terminal aesthetic - Black/green theme throughout
• Rate limiting - Upstash Redis for API protection
• CLI on npm - Install globally or use with npx

Next Steps

1. Enable Row Level Security (RLS) on database tables
2. Customize Supabase email templates with FoundersCode branding

Tech Stack

| Layer | Choice | |-------|--------| | Framework | Next.js 14 (App Router) | | Styling | Tailwind CSS | | Database | Supabase Postgres | | Auth | Supabase Auth | | ORM | Prisma 5 | | Email | Mailgun SMTP | | Rate Limiting | Upstash Redis | | CLI | TypeScript + Commander.js | | Hosting | Railway |

Getting Started

Prerequisites

• Node.js 18+
• Supabase account
• PostgreSQL database

Setup

# Install dependencies
npm install

# Set up environment variables
cp .env.local.example .env.local
# Edit .env.local with your Supabase credentials

# Push database schema
npx prisma db push

# Start dev server
npm run dev
# Visit http://localhost:3000

Environment Variables

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

# Database (pooler connection for app runtime)
DATABASE_URL=postgresql://postgres.xxx:[email protected]:6543/postgres?pgbouncer=true

# Feature flags (optional)
SHOW_LANDING=           # 'true'/'false' or empty for auto
MIN_USERS=100           # Users before showing community feed

# Site URL (for auth redirects)
NEXT_PUBLIC_SITE_URL=https://founderscode.dev  # Use http://localhost:3000 for local dev

CLI Commands

Installation

# Install globally
npm install -g founderscode

# Or use without installing
npx founderscode <command>

Commands

# Authenticate (opens browser)
fcode login

# Log out
fcode logout

# Log a push (after committing)
fcode push

# Show your status
fcode status

# Generate social post text
fcode post

# Manage projects
fcode project

CLI Flow

1. Run fcode login - opens browser for authentication
2. Sign in on the web
3. CLI receives token and saves it locally
4. Run fcode push after commits to track your streak

Project Structure

app/
  page.tsx              # Landing or community feed
  [username]/           # Public profiles
  dashboard/            # Private dashboard
    projects/           # Manage projects
    milestones/         # Manage milestones
    activity/           # Push history
    settings/           # Profile settings
  api/                  # API routes
    projects/           # Projects CRUD
    pushes/             # Pushes CRUD
    milestones/         # Milestones CRUD
    cli/auth/           # CLI authentication
  auth/                 # Auth pages
    cli/                # CLI authorization
    reset-password/     # Password reset
    update-password/    # New password form

cli/
  fc.ts                 # CLI entry point
  commands/             # CLI commands
  lib/                  # CLI utilities

components/
  LandingPage.tsx       # Pre-launch signup
  CommunityFeed.tsx     # Activity feed

lib/
  prisma.ts             # Prisma client
  supabase/             # Supabase clients
  api-auth.ts           # API authentication
  streak.ts             # Streak calculation
  features.ts           # Feature toggles

Design System

• Primary: Neon green (#00ff00)
• Background: Black (#0a0a0a)
• Text: White (primary), Gray (secondary)
• Font: JetBrains Mono
• Border: 1px green, 50px padding from edge

Database Schema

• User - Profile info, socials
• Project - User's projects with status
• Push - Logged commits/pushes
• Milestone - Achievement markers
• ApiToken - CLI authentication tokens
• CliAuthCode - Temporary auth codes for CLI flow

Repository

https://github.com/ramagetime/founderscode.git

License

ISC