Getting Started
Welcome! This guide walks you through the steps to launch your SaaS with warpkit.
1. Clone and install
git clone <your-repo>
cd your-app
bun install
2. Configure your app
Open config.ts at the project root. This is the single file you edit to brand your product:
const config = {
appName: 'My App',
domainName: 'myapp.com',
// ...
}
Update the app name, domain, and Stripe plan details here.
3. Set up environment variables
Copy .env.example to .env.local and fill in:
DATABASE_PATH: path to your SQLite metadata databaseBETTER_AUTH_SECRET: random secret for sessionsSTRIPE_SECRET_KEY: from your Stripe dashboardSTRIPE_WEBHOOK_SECRET: from your Stripe webhook endpointRESEND_API_KEY: for transactional email
4. Run migrations
bun db:migrate
This creates your metadata database with users, sessions, and subscription tables.
5. Start the dev server
bun dev
Visit http://localhost:3000. You should see the landing page.
6. Replace the example feature
Open src/features/example/: this is your starting point. Replace example_items with your domain entities, add your own migrations to src/db/user-migrations.ts, and update the route at src/routes/_app.example.tsx.
That's it. Ship your features, not infrastructure.