How ixartz/saas-boilerplate works
This repository is a Next.js SaaS starter: visitors explore a localized marketing site, then can sign in or sign up and reach dashboard, organization, and profile experiences. Its broader documented scope includes Clerk authentication, team tenancy and permissions, database support, billing, SEO, and operational reporting. The graph separates those product stages from shared configuration and persistence. Some documented subsystems are represented at their enclosing source directories because their implementation was not sampled; their internal wiring is therefore not asserted.
Main entry points: (marketing)/page.tsx Marketing page · I18nRouting.ts Locale routing · DBConnection.ts DB connection · dashboard/page.tsx Dashboard home
Components 23
Web experiences
- Marketing page
src/app/[locale]/(marketing)/page.tsx - Marketing sections
src/templates - Pricing presentation
src/features/billing - Dashboard home
src/app/[locale]/(auth)/dashboard/page.tsx - Dashboard interface
src/features/dashboard
Identity and teams
- Sign-in page
src/app/[locale]/(auth)/(center)/sign-in/[[...sign-in]]/page.tsx - Sign-up page
src/app/[locale]/(auth)/(center)/sign-up/[[...sign-up]]/page.tsx - Organization selection
src/app/[locale]/(auth)/onboarding/organization-selection/page.tsx - Organization profile
src/app/[locale]/(auth)/dashboard/organization-profile/[[...organization-profile]]/page.tsx - User profile
src/app/[locale]/(auth)/dashboard/user-profile/[[...user-profile]]/page.tsx - Teams and permissions
src/app/[locale]/(auth)
Shared platform
- Locale routing
src/libs/I18nRouting.ts - Locale switcher
src/components/LocaleSwitcher.tsx - App configuration
src/utils/AppConfig.ts - Request proxy
src/proxy.ts
Operations and data
- Database access
src/libs/DB.ts - Data schema
src/models/Schema.ts - DB connection
src/utils/DBConnection.ts - SEO metadata
src/app/sitemap.ts - Logging
src/libs/Logger.ts - Error reporting
src/instrumentation.ts
Other components
- Visitor
- Clerk identity
Connections 20
- Visitor → Marketing page: opens
src/app/[locale]/(marketing)/page.tsx - Marketing page → Marketing sections: renders
src/app/[locale]/(marketing)/page.tsx - Marketing page → Pricing presentation: presents plans
README.md - Visitor → Sign-in page: authenticates
README.md - Visitor → Sign-up page: registers
README.md - Sign-in page → Clerk identity: uses identity
README.md - Sign-up page → Clerk identity: uses identity
README.md - Visitor → Dashboard home: opens
README.md - Dashboard home → Dashboard interface: renders
src/app/[locale]/(auth)/dashboard/page.tsx - Visitor → Organization selection: selects team
README.md - Visitor → Organization profile: manages team
README.md - Visitor → User profile: manages profile
README.md - Teams and permissions → Clerk identity: supports teams
README.md - Locale switcher → Locale routing: navigates locales
src/components/LocaleSwitcher.tsx - Locale routing → App configuration: reads settings
src/libs/I18nRouting.ts - Request proxy → Locale routing: uses routing
src/proxy.ts - DB connection → Data schema: uses schema
src/utils/DBConnection.ts - DB connection → Logging: uses logger
src/utils/DBConnection.ts - Database access → Data schema: models data
README.md - Visitor → SEO metadata: discovers pages
README.md