Review your app's name and setup defaults before Kickstart creates the hosted services. You can keep the defaults while exploring, or adjust the choices below for your product.
Before you begin
Complete Accounts first. Your root .env, beside package.json, should already contain SUPABASE_ACCESS_TOKEN, STRIPE_TEST_SECRET_KEY (for the default billing setup) and RESEND_API_KEY.
Edit that existing file and keep one line per setting. If you haven't created it or saved your keys, follow where to save your keys.
Kickstart reads only the root .env, so avoid conflicting values in .env.local. The same privacy rules apply to every setting in this file.
Name your app
Update these existing entries in .env:
APP_NAME=Forma
APP_URL=http://localhost:3000Replace Forma with your product's name, or keep it while exploring. APP_NAME sets the configured app name and helps name resources created during setup. It doesn't rename existing provider resources or replace logos, page copy and email wording; those belong in branding.
Keep the local URL for your first run. Your browser address and the configured URL need to match for sign-in to work.
Review the setup defaults
These defaults give you a local app with hosted services and Stripe test billing. Review the database location and initial billing plans before provisioning, because Kickstart uses those choices when it creates resources.
| Choice | Default | When to change it |
|---|---|---|
| Database location | US East, with another available US region as fallback | Set SUPABASE_REGION before creation if you need a specific available region. |
| Email verification | AUTH_EMAIL_VERIFICATION=false | Set it to true to require new users to confirm their email before signing in. |
| AI chat | AI_ENABLED=false | Set it to true and add OPENROUTER_API_KEY to include AI in your first installation. |
| Billing | Enabled with sample Starter, Pro and Growth plans | Edit config/billing-seed.json before installation to change the initial plans or disable billing. |
| Email sender | Automatic selection | Choose a verified sender if you already have a domain ready. |
| Search indexing | SEO_INDEXABLE=false | Keep it off while building; enable it when your public pages are ready to launch. |
If Resend has no verified sending domain, the default test sender delivers only to your Resend account email. Use that exact address for signup and recovery testing. Sending to other people requires a verified domain.
Let Kickstart fill in the rest
On a fresh installation, leave the project keys, project IDs, email template IDs and webhook secrets in the Kickstart fills in sections blank. Kickstart saves those values as it creates and connects your services. The optional sender choices above are the exception when you want to override discovery.
If you've already run Kickstart, preserve its generated values and private recovery files. Follow safe reruns to resume that installation.
For individual environment fields and later source changes, use the Configuration reference.
When your local app works, Deployment Kickstart covers the extra settings for going live.
Ready for Kickstart
Save your changes and confirm:
- Your required credentials are in the existing root
.env. - Your app name, local URL and setup choices are ready, including an OpenRouter key if you enabled AI.
- Generated fields are blank for a fresh installation, or preserved if you're resuming one.
You can now check the accounts and install your app on the next page.
Template 0.0.1 · September 2026 source snapshot