SaaS AI Starter

Generates a complete React/Node.js/Prisma SaaS application from a single main.wasp configuration file that declaratively specifies routes, API endpoints, database models, authentication flows, and external service integrations. The Wasp compiler parses this DSL and generates boilerplate code, type definitions, and build artifacts, eliminating manual wiring between frontend, backend, and database layers while maintaining end-to-end type safety through TypeScript code generation.

Implements a complete authentication system supporting email/password signup and login, OAuth2 flows for Google and GitHub, and session management via HTTP-only cookies. The system uses Wasp's built-in auth middleware to protect routes, automatically handle token refresh, and provide user context to frontend components through React hooks, with database persistence via Prisma User model and optional email verification workflows.

Organizes the codebase into feature modules (auth/, payment/, demo-ai-app/, file-upload/, admin/) with clear separation of concerns. Each feature module contains related components, backend functions, and utilities. Shared utilities (common.ts, hooks, types) are centralized in a shared/ directory and imported across features. This structure enables developers to understand and modify features independently while maintaining consistency through shared patterns and utilities.

Generates a comprehensive documentation site using Astro Starlight (opensaas-sh/blog/) that includes guided tours, API documentation, deployment guides, and feature explanations. The documentation is version-controlled alongside the template code and automatically deployed to opensaas.sh. Developers can update documentation by editing Markdown files, and changes are reflected in the live site without manual deployment steps.

Provides a working demo application that showcases task management features (create, list, update, delete tasks) integrated with OpenAI for automatic task summarization. Users can create tasks, view a list of all tasks, and trigger AI-powered summarization that generates a summary of all tasks and optionally sends it via email. This demo serves as both a reference implementation for building features and a showcase of AI integration capabilities.

Integrates Stripe for subscription billing, one-time payments, and usage-based pricing through a pre-built payment module that handles checkout session creation, webhook event processing (subscription updates, payment failures), and subscription state synchronization with the Prisma database. The system automatically updates user subscription status on Stripe events, provides pricing page templates, and includes checkout utilities that generate Stripe Checkout sessions with pre-filled customer data from authenticated user context.

Implements file upload to AWS S3 with presigned URL generation for secure, direct browser-to-S3 uploads that bypass the backend server. The system generates time-limited presigned URLs on the backend, validates file metadata (size, type) before upload, stores file references in the Prisma database with user ownership tracking, and provides utilities for file retrieval and deletion. This architecture reduces backend bandwidth usage and enables large file uploads without server-side buffering.

Provides a pre-built integration with OpenAI's API for text generation, including task scheduling via cron jobs (e.g., daily email summaries) and streaming response handling for real-time LLM output to the frontend. The system wraps OpenAI client initialization with API key management, provides utility functions for common prompts (task summarization, email generation), and includes Wasp scheduled jobs that execute backend functions on a cron schedule to trigger AI operations asynchronously.

Provides a pre-built admin interface for viewing all users, their subscription status, payment history, and application analytics (user growth, revenue, churn). The dashboard queries the Prisma database to aggregate user and payment data, displays charts and tables with filtering/sorting capabilities, and includes user management actions (view details, update subscription, send emails). Access is restricted to admin users via role-based authorization checks in Wasp route definitions.

Uses Prisma ORM to define database schema (User, Subscription, File, Task models) with automatic migration generation and version control. Developers modify the schema.prisma file, run `prisma migrate dev` to generate SQL migrations, and Wasp automatically applies migrations during deployment. The system includes seed scripts for populating test data and provides type-safe database access from backend functions through Prisma client.

Automatically generates TypeScript types for all Wasp-defined entities (routes, API endpoints, database models) and enforces type contracts between frontend and backend at compile time. When you define an API endpoint in main.wasp, Wasp generates both the backend handler type and the frontend client function with matching input/output types. This eliminates runtime type mismatches and provides IDE autocomplete for API calls, database queries, and authentication context.

Includes a pre-configured Playwright test suite (e2e-tests/ directory) that tests critical user flows (signup, login, payment, file upload) across the full stack. Tests run against a real browser instance and interact with the actual application, database, and external services (Stripe sandbox, S3 test bucket). The test suite includes fixtures for user creation, authentication, and cleanup, enabling developers to write tests that verify end-to-end functionality without mocking.

Provides pre-configured deployment scripts and environment variable templates for deploying to Fly.io or Railway with a single command. The deployment process builds the Wasp application, generates Docker images, provisions PostgreSQL databases, configures environment variables (API keys, database URLs), and deploys the application with automatic HTTPS and domain setup. Developers can deploy with `wasp deploy` without manually managing infrastructure or writing Dockerfiles.