Web / Getting started
Introduction
Get to know the foundation, then make it yours.
Build from a shared foundation
supastack is a modular foundation for AI SaaS on web and mobile. The web surface uses Next.js for the interface and backend-for-frontend. Shared TypeScript packages handle identity, workspaces, billing, AI, jobs, email, and observability.
Start with the local reference flow to understand how the modules fit together. Configure production providers only after that flow works in your environment.
Find your way around
Applications compose the shared packages. Product-specific features belong in the consuming product codebase rather than in the reusable core.
apps/
web/ Next.js interface and API routes
mobile/ Expo application
packages/
auth/ Identity and sessions
db/ Schema and workspace persistence
billing/ Billing and entitlements
ai/ Providers, routing, and usage
jobs/ Background job contract
email/ Transactional deliveryChoose your starting point
Follow Local setup to prepare the workspace and run the deterministic checks. Use the Mobile tab for Expo configuration, or Modules to explore the contracts underneath both applications.
The local golden path has passed in the project’s development environment. Timed clean-clone setup, real-provider smoke, deployment, and physical-device acceptance remain separate verification steps.