How rovidev95/rovidev-saas-starter works
saas-starter is a multi-tenant SaaS foundation: users register or log in, create or enter an organization, then use tenant-scoped project, member, and billing areas. Its domain stages include session-based authentication, organization membership and role checks, plan-limit enforcement, and Stripe subscription checkout, portal management, and webhook updates. Prisma/PostgreSQL provides persistence. The graph follows documented capabilities, but unsampled member and organization internals are represented only where the tree and README establish them; dashed edges mark documented behavior without a sampled caller.
Main entry points: db.ts Prisma client · route.ts Stripe webhook · billing.ts Checkout and portal · tenant.ts Tenant boundary
Components 25
Authentication
- Login and registration
src/app/(auth)/login/page.tsx - Auth actions
src/app/actions/auth.ts - Current user lookup
src/lib/auth.ts - Signed sessions
src/lib/session.ts
Tenant workspace
- Workspace selection
src/app/dashboard/page.tsx - Create organization
src/components/CreateOrgForm.tsx - Organization actions
src/app/actions/org.ts - Organization overview
src/app/dashboard/[slug]/page.tsx - Tenant navigation
src/components/TenantNav.tsx - Project form
src/components/CreateProjectForm.tsx - Member management
src/app/dashboard/[slug]/members/page.tsx - Marketing and pricing
src/app/page.tsx
Domain policies
- Tenant boundary
src/lib/tenant.ts - Role permissions
src/lib/rbac.ts - Plans and limits
src/lib/plans.ts
Billing
- Billing workspace
src/app/dashboard/[slug]/billing/page.tsx - Checkout and portal
src/app/actions/billing.ts - Stripe webhook
src/app/api/stripe/webhook/route.ts - Subscription mapping
src/lib/billing.ts
Persistence and services
- Prisma client
src/lib/db.ts - PostgreSQL data model
prisma/schema.prisma - Runtime configuration
src/lib/env.ts - Stripe client
src/lib/stripe.ts
Other components
- User
- Stripe
Connections 47
- User → Login and registration: submits credentials
src/app/(auth)/login/page.tsx - Login and registration → Auth actions: calls auth actions
src/app/(auth)/login/page.tsx - Auth actions → Prisma client: reads and creates users
src/app/actions/auth.ts - Auth actions → Signed sessions: starts or ends session
src/app/actions/auth.ts - Auth actions → Workspace selection: redirects after login
src/app/actions/auth.ts - Signed sessions → Runtime configuration: loads signing secret
src/lib/session.ts - Workspace selection → Current user lookup: requires current user
src/app/dashboard/page.tsx - Current user lookup → Signed sessions: reads session user
src/lib/auth.ts - Current user lookup → Prisma client: loads user memberships
src/lib/auth.ts - Workspace selection → Create organization: renders creation form
src/app/dashboard/page.tsx - Create organization → Organization actions: submits organization
src/components/CreateOrgForm.tsx - Organization actions → Prisma client: persists organization data
src/app/actions/org.ts - Organization actions → Tenant boundary: resolves tenant
src/app/actions/org.ts - Organization actions → Role permissions: checks permissions
src/app/actions/org.ts - Organization actions → Plans and limits: checks plan limits
src/app/actions/org.ts - Organization overview → Tenant boundary: resolves tenant
src/app/dashboard/[slug]/page.tsx - Organization overview → Prisma client: loads projects and seats
src/app/dashboard/[slug]/page.tsx - Organization overview → Role permissions: checks project permissions
src/app/dashboard/[slug]/page.tsx - Organization overview → Plans and limits: computes usage limits
src/app/dashboard/[slug]/page.tsx - Organization overview → Tenant navigation: renders navigation
src/app/dashboard/[slug]/page.tsx - Organization overview → Project form: renders project form
src/app/dashboard/[slug]/page.tsx - Member management → Tenant boundary: resolves tenant
src/app/dashboard/[slug]/members/page.tsx - Member management → Prisma client: loads member data
src/app/dashboard/[slug]/members/page.tsx - Member management → Tenant navigation: renders navigation
src/app/dashboard/[slug]/members/page.tsx - Tenant boundary → Signed sessions: gets session user
src/lib/tenant.ts - Tenant boundary → Prisma client: checks organization membership
src/lib/tenant.ts - Billing workspace → Tenant boundary: resolves tenant
src/app/dashboard/[slug]/billing/page.tsx - Billing workspace → Role permissions: checks billing access
src/app/dashboard/[slug]/billing/page.tsx - Billing workspace → Plans and limits: shows plan details
src/app/dashboard/[slug]/billing/page.tsx - Billing workspace → Subscription mapping: maps subscription status
src/app/dashboard/[slug]/billing/page.tsx - Billing workspace → Checkout and portal: offers billing actions
src/app/dashboard/[slug]/billing/page.tsx - Checkout and portal → Tenant boundary: resolves tenant
src/app/actions/billing.ts - Checkout and portal → Role permissions: checks billing permission
src/app/actions/billing.ts - Checkout and portal → Stripe client: creates checkout or portal
src/app/actions/billing.ts - Checkout and portal → Runtime configuration: reads prices and URLs
src/app/actions/billing.ts - Stripe client → Runtime configuration: loads Stripe key
src/lib/stripe.ts - Stripe client → Stripe: calls Stripe API
src/lib/stripe.ts - Stripe → Stripe webhook: posts subscription events
README.md - Stripe webhook → Stripe client: verifies and retrieves events
src/app/api/stripe/webhook/route.ts - Stripe webhook → Runtime configuration: reads webhook secret
src/app/api/stripe/webhook/route.ts - Stripe webhook → Prisma client: records event id
src/app/api/stripe/webhook/route.ts - Stripe webhook → Subscription mapping: maps event status
src/app/api/stripe/webhook/route.ts - Stripe webhook → Plans and limits: maps Stripe price
src/app/api/stripe/webhook/route.ts - Stripe webhook → Checkout and portal: persists subscription
src/app/api/stripe/webhook/route.ts - Checkout and portal → Prisma client: upserts subscription
src/app/actions/billing.ts - Prisma client → PostgreSQL data model: persists application records
README.md - Marketing and pricing → Plans and limits: shows plan options
src/app/page.tsx