The fast path: clone the repo, run
pnpm bootstrap, then pnpm dev. That’s it.What you get right away
With just the minimum setup (database + one AI provider), you can already use:AI Chat
Multi-model chat with streaming
Marketing Plan
Schema-based business tool
Launch Simulator
Fun Product Hunt simulation
Dashboard
Full app shell with credits
Landing Page
Marketing site at
/landingAuth
Email/password sign-in ready
What needs extra setup later?
What needs extra setup later?
These features work great but need additional configuration beyond the basics:
- Storage-backed flows — chat documents, uploads, generated asset history
- Video Studio — video model credentials + storage
- Voice Studio — ElevenLabs + storage
- Payments, email, analytics, Sentry — all optional
- PDF RAG and embeddings — needs OpenAI + storage + pgvector
- Extra AI providers — beyond your first LLM
What you need
Before you start, make sure you have:- Node.js 20.9+ (required for Next.js 16)
- pnpm (the package manager)
- A PostgreSQL database (Supabase recommended)
- At least one AI provider key — OpenAI, Google Gemini, Anthropic, Groq, xAI, or DeepSeek
Setup
- Quick path (recommended)
- Manual path
The bootstrap wizard handles the core setup for you.The wizard walks you through the core setup:Open http://localhost:3000 and you’re live.
Run the setup wizard
- Checks your Node version
- Runs
pnpm install - Sets
NEXT_PUBLIC_APP_URL - Auto-generates
BETTER_AUTH_SECRET - Configures
DATABASE_URLand runs migrations - Sets up your first AI provider and optional extra providers
- Optionally configures Replicate, ElevenLabs, email, OAuth, analytics, storage, payments, and Sentry
Start the app
Important things to know
The document/RAG features need
pgvector support in your Postgres database. The repo enables the extension in its migration history, but your database provider must actually allow CREATE EXTENSION vector.Supabase PostgreSQL is the recommended database host. It supports all required extensions out of the box. Neon, Railway, Render, Fly, and self-hosted Postgres all work too.
Verify your first run
Your setup is working if you can:
- Open the landing page
- Sign in with email/password
- Enter the dashboard
- Use the chat app with your configured AI provider
- Use Marketing Plan or Launch Simulator
- Open the landing page at
/landing
What’s next?
Database
Understand the PostgreSQL + Drizzle data layer.
Authentication
Add Google OAuth, magic links, and more.
Storage
Enable uploads and file-backed workflows.
AI SDK
Learn how the AI layer works across apps.
Payments
Start accepting money with Stripe, LemonSqueezy, or Polar.
Deployment
Ship it to Vercel when you’re ready.
Common mistakes to avoid
Common mistakes to avoid
BETTER_AUTH_SECRETis missingDATABASE_URLis missing- Email provider configured without
AUTH_EMAIL_FROM - Google OAuth callback URLs missing
/api/auth/callback/google - Copied
.env.exampleto.envinstead of.env.local - Storage not configured but expecting uploads to work
NEXT_PUBLIC_ANALYTICS_PROVIDERusing wrong syntax for multiple providers

