# t3-oss/create-t3-app architecture

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

- Interactive diagram: https://gitdiagram.com/t3-oss/create-t3-app
- Repository: https://github.com/t3-oss/create-t3-app

## Overview

create-t3-app is an interactive CLI that scaffolds a configurable, typesafe Next.js application, accompanied by a multilingual documentation site. The main workflow gathers project choices, prepares a tailored template, installs selected dependencies, then performs project setup and reports next steps. Optional integrations include tRPC, authentication, database/ORM, styling, and linting choices. The graph also captures documentation search and Open Graph generation. Some installer internals and template wiring are unsampled, so those links are omitted or marked unverified rather than inferred.

Main entry points: [`cli/src/index.ts`](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/index.ts) (CLI orchestrator), [`www/src/pages/og.ts`](https://github.com/t3-oss/create-t3-app/blob/main/www/src/pages/og.ts) (Open Graph route), [`cli/src/helpers/createProject.ts`](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/createProject.ts) (Project setup), [`www/src/components/navigation/Search.tsx`](https://github.com/t3-oss/create-t3-app/blob/main/www/src/components/navigation/Search.tsx) (Documentation search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Project creation CLI"]
  node_prompt["CLI prompts<br/>[index.ts]"]
  node_entry["CLI orchestrator<br/>[index.ts]"]
  node_version["Version warning"]
  node_project["Project setup<br/>[createProject.ts]"]
  node_boilerplate["Boilerplate selection"]
  node_logger["CLI logging<br/>[logger.ts]"]
end

subgraph group_setup["Generated app options"]
  node_installer_map["Installer selection<br/>[index.ts]"]
  node_integrations["Optional integrations"]
  node_scaffold["Template scaffolding<br/>[scaffoldProject.ts]"]
  node_dependencies["Dependency installation"]
  node_format["Project formatting<br/>[format.ts]"]
  node_git["Git initialization<br/>[git.ts]"]
  node_next_steps["Next-step guidance<br/>[logNextSteps.ts]"]
end

subgraph group_templates["App template runtime"]
  node_app_templates["Generated app templates"]
  node_trpc_client["tRPC query client<br/>[query-client.ts]"]
  node_trpc_server["tRPC server helpers<br/>[server.ts]"]
  node_auth_session["Auth session helper<br/>[server.ts]"]
end

subgraph group_docs["Documentation site"]
  node_site_config["Site and docs config<br/>[config.ts]"]
  node_language["Language helpers<br/>[languages.ts]"]
  node_search["Documentation search<br/>[Search.tsx]"]
  node_og_route["Open Graph route<br/>[og.ts]"]
  node_og_view["Open Graph renderer<br/>[openGraph.tsx]"]
  node_font_loader["OG font loader<br/>[ogFont.ts]"]
  node_site_url["Site URL helper<br/>[siteUrl.ts]"]
end

node_developer(("Developer"))
node_docs_user(("Documentation visitor"))
node_algolia["Algolia DocSearch"]

node_developer -->|"starts"| node_entry
node_entry -->|"checks version"| node_version
node_entry -->|"collects choices"| node_prompt
node_entry -->|"builds installer map"| node_installer_map
node_entry -->|"creates project"| node_project
node_project -.->|"selects template"| node_boilerplate
node_project -.->|"scaffolds files"| node_scaffold
node_entry -->|"installs dependencies"| node_dependencies
node_entry -->|"formats project"| node_format
node_entry -->|"initializes Git"| node_git
node_entry -->|"reports next steps"| node_next_steps
node_entry -->|"logs errors"| node_logger
node_installer_map -.->|"selects options"| node_integrations
node_project -->|"generates tailored app"| node_app_templates
node_app_templates -.->|"may include"| node_trpc_client
node_trpc_server -->|"creates query client"| node_trpc_client
node_auth_session -->|"reads request headers"| node_auth_session
node_docs_user -->|"searches docs"| node_search
node_search -->|"reads search settings"| node_site_config
node_search -->|"opens search"| node_algolia
node_docs_user -.->|"requests image"| node_og_route
node_og_route -->|"renders image layout"| node_og_view
node_og_route -->|"reads defaults"| node_site_config
node_og_route -->|"resolves language"| node_language
node_og_route -->|"loads fonts"| node_font_loader
node_og_route -->|"uses site URL"| node_site_url
node_language -->|"uses language types"| node_site_config

click node_prompt "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/cli/index.ts"
click node_entry "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/index.ts"
click node_version "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/utils/renderVersionWarning.ts"
click node_project "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/createProject.ts"
click node_boilerplate "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/selectBoilerplate.ts"
click node_installer_map "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/installers/index.ts"
click node_integrations "https://github.com/t3-oss/create-t3-app/tree/main/cli/src/installers"
click node_scaffold "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/scaffoldProject.ts"
click node_dependencies "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/installDependencies.ts"
click node_format "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/format.ts"
click node_git "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/git.ts"
click node_next_steps "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/logNextSteps.ts"
click node_logger "https://github.com/t3-oss/create-t3-app/blob/main/cli/src/utils/logger.ts"
click node_app_templates "https://github.com/t3-oss/create-t3-app/tree/main/cli/template"
click node_trpc_client "https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/trpc/query-client.ts"
click node_trpc_server "https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/trpc/server.ts"
click node_auth_session "https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/server/better-auth/server.ts"
click node_site_config "https://github.com/t3-oss/create-t3-app/blob/main/www/src/config.ts"
click node_language "https://github.com/t3-oss/create-t3-app/blob/main/www/src/languages.ts"
click node_search "https://github.com/t3-oss/create-t3-app/blob/main/www/src/components/navigation/Search.tsx"
click node_og_route "https://github.com/t3-oss/create-t3-app/blob/main/www/src/pages/og.ts"
click node_og_view "https://github.com/t3-oss/create-t3-app/blob/main/www/src/components/openGraph.tsx"
click node_font_loader "https://github.com/t3-oss/create-t3-app/blob/main/www/src/utils/ogFont.ts"
click node_site_url "https://github.com/t3-oss/create-t3-app/blob/main/www/src/utils/siteUrl.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_prompt,node_entry,node_version,node_project,node_boilerplate,node_logger toneBlue
class node_installer_map,node_integrations,node_scaffold,node_dependencies,node_format,node_git,node_next_steps toneAmber
class node_app_templates,node_trpc_client,node_trpc_server,node_auth_session toneMint
class node_site_config,node_language,node_search,node_og_route,node_og_view,node_font_loader,node_site_url toneRose
class node_developer,node_docs_user,node_algolia toneIndigo
```

## Components

### Project creation CLI

- [CLI prompts](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/cli/index.ts): `cli/src/cli/index.ts`
- [CLI orchestrator](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/index.ts): `cli/src/index.ts`
- [Version warning](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/utils/renderVersionWarning.ts): `cli/src/utils/renderVersionWarning.ts`
- [Project setup](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/createProject.ts): `cli/src/helpers/createProject.ts`
- [Boilerplate selection](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/selectBoilerplate.ts): `cli/src/helpers/selectBoilerplate.ts`
- [CLI logging](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/utils/logger.ts): `cli/src/utils/logger.ts`

### Generated app options

- [Installer selection](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/installers/index.ts): `cli/src/installers/index.ts`
- [Optional integrations](https://github.com/t3-oss/create-t3-app/tree/main/cli/src/installers): `cli/src/installers`
- [Template scaffolding](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/scaffoldProject.ts): `cli/src/helpers/scaffoldProject.ts`
- [Dependency installation](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/installDependencies.ts): `cli/src/helpers/installDependencies.ts`
- [Project formatting](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/format.ts): `cli/src/helpers/format.ts`
- [Git initialization](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/git.ts): `cli/src/helpers/git.ts`
- [Next-step guidance](https://github.com/t3-oss/create-t3-app/blob/main/cli/src/helpers/logNextSteps.ts): `cli/src/helpers/logNextSteps.ts`

### App template runtime

- [Generated app templates](https://github.com/t3-oss/create-t3-app/tree/main/cli/template): `cli/template`
- [tRPC query client](https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/trpc/query-client.ts): `cli/template/extras/src/trpc/query-client.ts`
- [tRPC server helpers](https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/trpc/server.ts): `cli/template/extras/src/trpc/server.ts`
- [Auth session helper](https://github.com/t3-oss/create-t3-app/blob/main/cli/template/extras/src/server/better-auth/server.ts): `cli/template/extras/src/server/better-auth/server.ts`

### Documentation site

- [Site and docs config](https://github.com/t3-oss/create-t3-app/blob/main/www/src/config.ts): `www/src/config.ts`
- [Language helpers](https://github.com/t3-oss/create-t3-app/blob/main/www/src/languages.ts): `www/src/languages.ts`
- [Documentation search](https://github.com/t3-oss/create-t3-app/blob/main/www/src/components/navigation/Search.tsx): `www/src/components/navigation/Search.tsx`
- [Open Graph route](https://github.com/t3-oss/create-t3-app/blob/main/www/src/pages/og.ts): `www/src/pages/og.ts`
- [Open Graph renderer](https://github.com/t3-oss/create-t3-app/blob/main/www/src/components/openGraph.tsx): `www/src/components/openGraph.tsx`
- [OG font loader](https://github.com/t3-oss/create-t3-app/blob/main/www/src/utils/ogFont.ts): `www/src/utils/ogFont.ts`
- [Site URL helper](https://github.com/t3-oss/create-t3-app/blob/main/www/src/utils/siteUrl.ts): `www/src/utils/siteUrl.ts`

### Other components

- **Developer**
- **Documentation visitor**
- **Algolia DocSearch**

## Connections

- Developer → CLI orchestrator: starts
- CLI orchestrator → Version warning: checks version (evidence: `cli/src/index.ts`)
- CLI orchestrator → CLI prompts: collects choices (evidence: `cli/src/index.ts`)
- CLI orchestrator → Installer selection: builds installer map (evidence: `cli/src/index.ts`)
- CLI orchestrator → Project setup: creates project (evidence: `cli/src/index.ts`)
- Project setup → Boilerplate selection: selects template
- Project setup → Template scaffolding: scaffolds files
- CLI orchestrator → Dependency installation: installs dependencies (evidence: `cli/src/index.ts`)
- CLI orchestrator → Project formatting: formats project (evidence: `cli/src/index.ts`)
- CLI orchestrator → Git initialization: initializes Git (evidence: `cli/src/index.ts`)
- CLI orchestrator → Next-step guidance: reports next steps (evidence: `cli/src/index.ts`)
- CLI orchestrator → CLI logging: logs errors (evidence: `cli/src/index.ts`)
- Installer selection → Optional integrations: selects options
- Project setup → Generated app templates: generates tailored app
- Generated app templates → tRPC query client: may include (evidence: `cli/template/extras/src/trpc/server.ts`)
- tRPC server helpers → tRPC query client: creates query client (evidence: `cli/template/extras/src/trpc/server.ts`)
- Auth session helper → Auth session helper: reads request headers (evidence: `cli/template/extras/src/server/better-auth/server.ts`)
- Documentation visitor → Documentation search: searches docs (evidence: `www/src/components/navigation/Search.tsx`)
- Documentation search → Site and docs config: reads search settings (evidence: `www/src/components/navigation/Search.tsx`)
- Documentation search → Algolia DocSearch: opens search (evidence: `www/src/components/navigation/Search.tsx`)
- Documentation visitor → Open Graph route: requests image
- Open Graph route → Open Graph renderer: renders image layout (evidence: `www/src/pages/og.ts`)
- Open Graph route → Site and docs config: reads defaults (evidence: `www/src/pages/og.ts`)
- Open Graph route → Language helpers: resolves language (evidence: `www/src/pages/og.ts`)
- Open Graph route → OG font loader: loads fonts (evidence: `www/src/pages/og.ts`)
- Open Graph route → Site URL helper: uses site URL (evidence: `www/src/pages/og.ts`)
- Language helpers → Site and docs config: uses language types (evidence: `www/src/languages.ts`)
