This repository provides a comprehensive boilerplate for building Software-as-a-Service (SaaS) applications using Nuxt 3, Supabase, and a suite of modern web technologies. It targets developers aiming to rapidly launch a multi-tenant SaaS product with integrated user management, payments, and AI features, significantly reducing initial setup time and complexity.

How It Works

The architecture emphasizes separation of concerns and minimal vendor lock-in. It employs Nuxt 3's Composition API for a unified development experience, Prisma for robust schema management and type-safe database access, and tRPC for efficient, type-safe client-server communication. Supabase handles authentication (including OAuth) and PostgreSQL, while Stripe manages payment processing and webhooks. Pinia is used for state management, and Tailwind CSS with daisyUI provides a flexible styling foundation.

Quick Start & Requirements

• Install: yarn, npm install, or pnpm install --shamefully-hoist
• Prerequisites: Node.js, Supabase account, Stripe account.
• Setup: Requires configuring environment variables for Supabase and Stripe. Database schema is managed via Prisma (npx prisma db push, npx prisma generate, npx prisma db seed).
• Local Development: Run npm run dev. Stripe webhooks can be debugged locally using stripe listen --forward-to localhost:3000/webhook.
• Docs: Deployment guidance available.

Highlighted Details

• Full user management: Social sign-on, email/password, password recovery, roles, and plan management.
• Multi-user accounts (Teams) with role-based access control and invite system.
• Integrated Stripe payments with webhook handling for subscription management.
• AI features powered by OpenAI for text completions, with per-account usage limits.
• SSR-optimized note display and basic note management functionality.

Maintenance & Community

• The project is maintained by JavascriptMick.
• Community support is available via Discord.

Licensing & Compatibility

• The repository does not explicitly state a license in the README. This requires clarification for commercial use or closed-source linking.

Limitations & Caveats

The project is described as a "simple boilerplate" and lacks integration tests for authentication and subscription workflows. Support for advanced Stripe flows (e.g., failed payments, expiry notifications) and a dedicated help desk or knowledge base are marked as unimplemented. The README also notes that Netlify's environment variable handling can sometimes require manual redeployments.