# ixartz/saas-boilerplate architecture

> Architecture diagram of the GitHub repository ixartz/saas-boilerplate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ixartz/saas-boilerplate
- Repository: https://github.com/ixartz/saas-boilerplate

## Overview

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: [`src/app/[locale]/(marketing)/page.tsx`](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(marketing)/page.tsx) (Marketing page), [`src/libs/I18nRouting.ts`](https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/I18nRouting.ts) (Locale routing), [`src/utils/DBConnection.ts`](https://github.com/ixartz/saas-boilerplate/blob/main/src/utils/DBConnection.ts) (DB connection), [`src/app/[locale]/(auth)/dashboard/page.tsx`](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/page.tsx) (Dashboard home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experiences"]
  node_marketing["Marketing page<br/>[page.tsx]"]
  node_marketing_templates["Marketing sections"]
  node_pricing["Pricing presentation"]
  node_dashboard["Dashboard home<br/>[page.tsx]"]
  node_dashboard_ui["Dashboard interface"]
end

subgraph group_identity["Identity and teams"]
  node_sign_in["Sign-in page<br/>[page.tsx]"]
  node_sign_up["Sign-up page<br/>[page.tsx]"]
  node_org_selection["Organization selection<br/>[page.tsx]"]
  node_org_profile["Organization profile<br/>[page.tsx]"]
  node_user_profile["User profile<br/>[page.tsx]"]
  node_tenancy["Teams and permissions"]
end

subgraph group_platform["Shared platform"]
  node_i18n["Locale routing<br/>[I18nRouting.ts]"]
  node_locale_switcher["Locale switcher<br/>[LocaleSwitcher.tsx]"]
  node_app_config["App configuration<br/>[AppConfig.ts]"]
  node_proxy["Request proxy<br/>[proxy.ts]"]
end

subgraph group_ops["Operations and data"]
  node_database[("Database access<br/>[DB.ts]")]
  node_schema["Data schema<br/>[Schema.ts]"]
  node_db_connection["DB connection<br/>[DBConnection.ts]"]
  node_seo["SEO metadata<br/>[sitemap.ts]"]
  node_logging["Logging<br/>[Logger.ts]"]
  node_monitoring["Error reporting<br/>[instrumentation.ts]"]
end

node_visitor(("Visitor"))
node_clerk["Clerk identity"]

node_visitor -->|"opens"| node_marketing
node_marketing -->|"renders"| node_marketing_templates
node_marketing -.->|"presents plans"| node_pricing
node_visitor -.->|"authenticates"| node_sign_in
node_visitor -.->|"registers"| node_sign_up
node_sign_in -.->|"uses identity"| node_clerk
node_sign_up -.->|"uses identity"| node_clerk
node_visitor -.->|"opens"| node_dashboard
node_dashboard -->|"renders"| node_dashboard_ui
node_visitor -.->|"selects team"| node_org_selection
node_visitor -.->|"manages team"| node_org_profile
node_visitor -.->|"manages profile"| node_user_profile
node_tenancy -.->|"supports teams"| node_clerk
node_locale_switcher -->|"navigates locales"| node_i18n
node_i18n -->|"reads settings"| node_app_config
node_proxy -->|"uses routing"| node_i18n
node_db_connection -->|"uses schema"| node_schema
node_db_connection -->|"uses logger"| node_logging
node_database -.->|"models data"| node_schema
node_visitor -.->|"discovers pages"| node_seo

click node_marketing "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(marketing)/page.tsx"
click node_marketing_templates "https://github.com/ixartz/saas-boilerplate/tree/main/src/templates"
click node_pricing "https://github.com/ixartz/saas-boilerplate/tree/main/src/features/billing"
click node_dashboard "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/page.tsx"
click node_dashboard_ui "https://github.com/ixartz/saas-boilerplate/tree/main/src/features/dashboard"
click node_sign_in "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/(center)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx"
click node_sign_up "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/(center)/sign-up/%5B%5B...sign-up%5D%5D/page.tsx"
click node_org_selection "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/onboarding/organization-selection/page.tsx"
click node_org_profile "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/organization-profile/%5B%5B...organization-profile%5D%5D/page.tsx"
click node_user_profile "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/user-profile/%5B%5B...user-profile%5D%5D/page.tsx"
click node_tenancy "https://github.com/ixartz/saas-boilerplate/tree/main/src/app/%5Blocale%5D/(auth)"
click node_i18n "https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/I18nRouting.ts"
click node_locale_switcher "https://github.com/ixartz/saas-boilerplate/blob/main/src/components/LocaleSwitcher.tsx"
click node_app_config "https://github.com/ixartz/saas-boilerplate/blob/main/src/utils/AppConfig.ts"
click node_database "https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/DB.ts"
click node_schema "https://github.com/ixartz/saas-boilerplate/blob/main/src/models/Schema.ts"
click node_db_connection "https://github.com/ixartz/saas-boilerplate/blob/main/src/utils/DBConnection.ts"
click node_seo "https://github.com/ixartz/saas-boilerplate/blob/main/src/app/sitemap.ts"
click node_logging "https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/Logger.ts"
click node_monitoring "https://github.com/ixartz/saas-boilerplate/blob/main/src/instrumentation.ts"
click node_proxy "https://github.com/ixartz/saas-boilerplate/blob/main/src/proxy.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_marketing,node_marketing_templates,node_pricing,node_dashboard,node_dashboard_ui toneBlue
class node_sign_in,node_sign_up,node_org_selection,node_org_profile,node_user_profile,node_tenancy toneAmber
class node_i18n,node_locale_switcher,node_app_config,node_proxy toneMint
class node_database,node_schema,node_db_connection,node_seo,node_logging,node_monitoring toneRose
class node_visitor,node_clerk toneIndigo
```

## Components

### Web experiences

- [Marketing page](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(marketing)/page.tsx): `src/app/[locale]/(marketing)/page.tsx`
- [Marketing sections](https://github.com/ixartz/saas-boilerplate/tree/main/src/templates): `src/templates`
- [Pricing presentation](https://github.com/ixartz/saas-boilerplate/tree/main/src/features/billing): `src/features/billing`
- [Dashboard home](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/page.tsx): `src/app/[locale]/(auth)/dashboard/page.tsx`
- [Dashboard interface](https://github.com/ixartz/saas-boilerplate/tree/main/src/features/dashboard): `src/features/dashboard`

### Identity and teams

- [Sign-in page](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/(center)/sign-in/%5B%5B...sign-in%5D%5D/page.tsx): `src/app/[locale]/(auth)/(center)/sign-in/[[...sign-in]]/page.tsx`
- [Sign-up page](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/(center)/sign-up/%5B%5B...sign-up%5D%5D/page.tsx): `src/app/[locale]/(auth)/(center)/sign-up/[[...sign-up]]/page.tsx`
- [Organization selection](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/onboarding/organization-selection/page.tsx): `src/app/[locale]/(auth)/onboarding/organization-selection/page.tsx`
- [Organization profile](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/organization-profile/%5B%5B...organization-profile%5D%5D/page.tsx): `src/app/[locale]/(auth)/dashboard/organization-profile/[[...organization-profile]]/page.tsx`
- [User profile](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/%5Blocale%5D/(auth)/dashboard/user-profile/%5B%5B...user-profile%5D%5D/page.tsx): `src/app/[locale]/(auth)/dashboard/user-profile/[[...user-profile]]/page.tsx`
- [Teams and permissions](https://github.com/ixartz/saas-boilerplate/tree/main/src/app/%5Blocale%5D/(auth)): `src/app/[locale]/(auth)`

### Shared platform

- [Locale routing](https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/I18nRouting.ts): `src/libs/I18nRouting.ts`
- [Locale switcher](https://github.com/ixartz/saas-boilerplate/blob/main/src/components/LocaleSwitcher.tsx): `src/components/LocaleSwitcher.tsx`
- [App configuration](https://github.com/ixartz/saas-boilerplate/blob/main/src/utils/AppConfig.ts): `src/utils/AppConfig.ts`
- [Request proxy](https://github.com/ixartz/saas-boilerplate/blob/main/src/proxy.ts): `src/proxy.ts`

### Operations and data

- [Database access](https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/DB.ts): `src/libs/DB.ts`
- [Data schema](https://github.com/ixartz/saas-boilerplate/blob/main/src/models/Schema.ts): `src/models/Schema.ts`
- [DB connection](https://github.com/ixartz/saas-boilerplate/blob/main/src/utils/DBConnection.ts): `src/utils/DBConnection.ts`
- [SEO metadata](https://github.com/ixartz/saas-boilerplate/blob/main/src/app/sitemap.ts): `src/app/sitemap.ts`
- [Logging](https://github.com/ixartz/saas-boilerplate/blob/main/src/libs/Logger.ts): `src/libs/Logger.ts`
- [Error reporting](https://github.com/ixartz/saas-boilerplate/blob/main/src/instrumentation.ts): `src/instrumentation.ts`

### Other components

- **Visitor**
- **Clerk identity**

## Connections

- Visitor → Marketing page: opens (evidence: `src/app/[locale]/(marketing)/page.tsx`)
- Marketing page → Marketing sections: renders (evidence: `src/app/[locale]/(marketing)/page.tsx`)
- Marketing page → Pricing presentation: presents plans (evidence: `README.md`)
- Visitor → Sign-in page: authenticates (evidence: `README.md`)
- Visitor → Sign-up page: registers (evidence: `README.md`)
- Sign-in page → Clerk identity: uses identity (evidence: `README.md`)
- Sign-up page → Clerk identity: uses identity (evidence: `README.md`)
- Visitor → Dashboard home: opens (evidence: `README.md`)
- Dashboard home → Dashboard interface: renders (evidence: `src/app/[locale]/(auth)/dashboard/page.tsx`)
- Visitor → Organization selection: selects team (evidence: `README.md`)
- Visitor → Organization profile: manages team (evidence: `README.md`)
- Visitor → User profile: manages profile (evidence: `README.md`)
- Teams and permissions → Clerk identity: supports teams (evidence: `README.md`)
- Locale switcher → Locale routing: navigates locales (evidence: `src/components/LocaleSwitcher.tsx`)
- Locale routing → App configuration: reads settings (evidence: `src/libs/I18nRouting.ts`)
- Request proxy → Locale routing: uses routing (evidence: `src/proxy.ts`)
- DB connection → Data schema: uses schema (evidence: `src/utils/DBConnection.ts`)
- DB connection → Logging: uses logger (evidence: `src/utils/DBConnection.ts`)
- Database access → Data schema: models data (evidence: `README.md`)
- Visitor → SEO metadata: discovers pages (evidence: `README.md`)
