Local Development · Docs

Starter ProLocal Development

Local environments should feel realLink to section

Starter Pro is designed so local development validates realistic SaaS behavior instead of disconnected demo pages.

The local environment supports:

authentication
billing
protected routes
Prisma
Stripe
PWA behavior
production-shaped workflows

Start from a production-shaped local environment.

Validate auth, billing, mobile UX, and product infrastructure before writing domain logic.

Getting started

One-time payment · Instant access after purchase

Core principle

Local development should validate product infrastructure, not only UI composition.

Why this mattersLink to section

Many SaaS products become difficult to scale because local development environments never reflected real production behavior.

That usually creates:

inconsistent auth flows
billing drift
broken onboarding
unsafe deployment assumptions
mobile UX regressions
fragile environment setup

Starter Pro is structured to reduce that operational drift from the start.

local-development-model.txt

Local setup
  ↓
Environment variables
  ↓
Database
  ↓
Auth
  ↓
Billing
  ↓
Protected routes
  ↓
PWA behavior
  ↓
Production confidence

Production insight

A strong local setup is not about convenience only. It is the first release gate for your product infrastructure.

Mental modelLink to section

Infrastructure layer

The infrastructure layer includes environment variables, database access, local services, and development scripts.

EnvironmentPostgreSQLPrisma

Included infrastructureLink to section

Authentication

Credentials auth, OAuth providers, sessions, and protected routing.

Billing

Stripe-ready billing infrastructure and subscription-aware flows.

Database

Prisma-powered PostgreSQL development environment.

PWA

Installable app behavior, offline routing, safe areas, and standalone testing.

Recommended setup flowLink to section

Install dependenciesLink to section

pnpm install

Configure environment variablesLink to section

cp .env.example .env.local

Start infrastructureLink to section

pnpm db:up

Seed and migrateLink to section

pnpm app:setup

Start developmentLink to section

pnpm dev

Local development checklistLink to section

Required

Infrastructure validation

Confirm the local environment is ready before customizing product logic.

dependencies installed
environment variables configured
database running
Prisma client generated
seed completed

Required

Product validation

Confirm that Starter Pro behaves like a real SaaS locally.

auth flows work
billing routes render
settings pages work
protected pages redirect correctly
PWA fallback works

Recommended validation checklistLink to section

Validate:

authentication flows
billing routes
protected pages
mobile responsiveness
PWA installability
offline fallback behavior
settings surfaces
local seed fixtures

Validation principle

Validate real product flows locally before customizing deeply.

Common mistakesLink to section

Demo-only environments

Testing isolated pages without validating real auth or billing behavior.

Skipping mobile validation

Ignoring standalone mode, safe areas, and mobile navigation behavior.

Environment drift

Letting local, staging, and production variables diverge without clear documentation.

Delayed validation

Customizing deeply before confirming the default product flows work.

Prefer / avoidLink to section

Prefer

validate auth before product customization
test billing locally with Stripe test mode
use seed fixtures for repeatable states
test mobile and standalone behavior
keep environment variables documented

Avoid

customizing before setup is validated
testing only static pages
skipping protected routes
using production secrets locally
ignoring PWA safe-area behavior

Environment VariablesConfigure auth, billing, database, and infrastructure safely.DeploymentDeploy Starter Pro with production-ready infrastructure.Testing fixturesValidate realistic account states and onboarding flows.PWA setupValidate local installability and app-like mobile behavior.