SaaS AI Starter

Generates a complete React/Node.js/Prisma SaaS application from a single main.wasp configuration file that declaratively defines routes, database schema, authentication flows, and API endpoints. The Wasp compiler parses this DSL and orchestrates code generation for both frontend and backend, eliminating boilerplate while maintaining type safety across the full stack through TypeScript integration.

Implements a complete authentication system supporting email/password signup and login, OAuth integration (Google, GitHub), and role-based authorization (user, admin) enforced at both the API and UI layers. Authentication state is managed through Wasp's built-in auth middleware that validates JWT tokens server-side and provides typed auth context to React components, with automatic session management and CSRF protection.

Includes a comprehensive Playwright test suite (e2e-tests/) that tests critical user flows like signup, login, payment checkout, and file uploads. Tests are written in TypeScript with page object patterns for maintainability, and can be run locally or in CI/CD pipelines. The template provides test examples that developers can extend for their own features, with configuration for running against local and production environments.

Includes pre-configured deployment setups for multiple platforms: Fly.io for the Node.js backend (with Docker containerization), Netlify for the React frontend, and traditional server deployment instructions. The template includes environment variable templates, database migration scripts, and CI/CD configuration examples that automate deployment from git pushes. Deployment guides cover both automated (GitHub Actions) and manual deployment workflows.

Leverages Wasp's DSL to automatically generate TypeScript types for API endpoints, eliminating manual type definitions and API contract management. When a backend action or query is defined in main.wasp, Wasp automatically generates corresponding TypeScript types for the frontend, ensuring frontend and backend stay in sync. This prevents common bugs where frontend sends incorrect data types or calls non-existent endpoints.

Provides a structured approach to managing environment variables across development, staging, and production environments through .env files and Wasp configuration. The template includes example .env.client and .env.server files showing which variables are needed for each environment, with clear separation between client-side (public) and server-side (secret) variables. Wasp automatically loads environment variables at build time and validates that required variables are present.

Provides pre-built integration with Stripe and Lemon Squeezy for handling one-time payments and recurring subscriptions, including checkout page generation, webhook handling for payment events, and subscription status tracking in the database. The template includes utility functions (checkoutUtils.ts) that manage the payment flow from pricing page to checkout redirect and webhook processing that updates user subscription status automatically.

Provides a demo application (demo-ai-app/) that shows how to integrate OpenAI's API for AI-powered features, including task creation with AI-generated content, scheduled task processing, and streaming responses. The integration uses Wasp's action system to call OpenAI endpoints server-side, with error handling and type-safe request/response structures defined in the Wasp DSL.

Integrates AWS S3 for file uploads with presigned URL generation, allowing clients to upload files directly to S3 without routing through the Node.js backend. The implementation includes file operation utilities (fileUpload.ts) that handle presigned URL generation, file metadata storage in the database, and cleanup of orphaned files. Wasp actions orchestrate the S3 API calls with proper error handling and type safety.

Provides a pre-built admin interface (admin/ directory) for managing users, viewing analytics, and monitoring application health. The dashboard includes user listing with filtering, role assignment, and analytics views that query the database for metrics like user signups, subscription status, and feature usage. Access is restricted to admin-role users through Wasp's authorization system, with all queries type-safe and database-backed.

Uses Prisma as the ORM layer for database schema definition and migrations, with the schema defined in schema.prisma and migrations automatically generated when schema changes are made. Wasp integrates Prisma seamlessly, providing type-safe database queries in both backend actions and scheduled tasks, with automatic TypeScript type generation from the schema. The template includes pre-defined schema for users, subscriptions, files, and tasks.

Provides a scheduling system for running backend tasks at specified intervals using cron expressions, implemented through Wasp's job system. Tasks are defined in the Wasp DSL with cron schedules and execute server-side code (e.g., processing AI tasks, sending emails, cleaning up old data). The template includes examples like scheduled task processing for the AI demo application, with error handling and execution logging.

Provides email sending capabilities through integration with SendGrid or Mailgun, with pre-configured email templates for common SaaS operations (password reset, welcome emails, subscription confirmations). The template includes utility functions for sending emails from backend actions, with environment variables for provider credentials. Email sending is non-blocking and integrates with the authentication system for password reset flows.

Includes a documentation site (opensaas-sh/blog/) built with Astro Starlight for hosting guides, API documentation, and deployment instructions. The documentation is version-controlled alongside the template code and deployed separately from the main application. The site includes guided tours, feature documentation, and deployment guides that help developers understand and extend the template.