How t3-oss/create-t3-app works
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: index.ts CLI orchestrator · og.ts Open Graph route · createProject.ts Project setup · Search.tsx Documentation search
Components 27
Project creation CLI
- CLI prompts
cli/src/cli/index.ts - CLI orchestrator
cli/src/index.ts - Version warning
cli/src/utils/renderVersionWarning.ts - Project setup
cli/src/helpers/createProject.ts - Boilerplate selection
cli/src/helpers/selectBoilerplate.ts - CLI logging
cli/src/utils/logger.ts
Generated app options
- Installer selection
cli/src/installers/index.ts - Optional integrations
cli/src/installers - Template scaffolding
cli/src/helpers/scaffoldProject.ts - Dependency installation
cli/src/helpers/installDependencies.ts - Project formatting
cli/src/helpers/format.ts - Git initialization
cli/src/helpers/git.ts - Next-step guidance
cli/src/helpers/logNextSteps.ts
App template runtime
- Generated app templates
cli/template - tRPC query client
cli/template/extras/src/trpc/query-client.ts - tRPC server helpers
cli/template/extras/src/trpc/server.ts - Auth session helper
cli/template/extras/src/server/better-auth/server.ts
Documentation site
- Site and docs config
www/src/config.ts - Language helpers
www/src/languages.ts - Documentation search
www/src/components/navigation/Search.tsx - Open Graph route
www/src/pages/og.ts - Open Graph renderer
www/src/components/openGraph.tsx - OG font loader
www/src/utils/ogFont.ts - Site URL helper
www/src/utils/siteUrl.ts
Other components
- Developer
- Documentation visitor
- Algolia DocSearch
Connections 27
- Developer → CLI orchestrator: starts
- CLI orchestrator → Version warning: checks version
cli/src/index.ts - CLI orchestrator → CLI prompts: collects choices
cli/src/index.ts - CLI orchestrator → Installer selection: builds installer map
cli/src/index.ts - CLI orchestrator → Project setup: creates project
cli/src/index.ts - Project setup → Boilerplate selection: selects template
- Project setup → Template scaffolding: scaffolds files
- CLI orchestrator → Dependency installation: installs dependencies
cli/src/index.ts - CLI orchestrator → Project formatting: formats project
cli/src/index.ts - CLI orchestrator → Git initialization: initializes Git
cli/src/index.ts - CLI orchestrator → Next-step guidance: reports next steps
cli/src/index.ts - CLI orchestrator → CLI logging: logs errors
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
cli/template/extras/src/trpc/server.ts - tRPC server helpers → tRPC query client: creates query client
cli/template/extras/src/trpc/server.ts - Auth session helper → Auth session helper: reads request headers
cli/template/extras/src/server/better-auth/server.ts - Documentation visitor → Documentation search: searches docs
www/src/components/navigation/Search.tsx - Documentation search → Site and docs config: reads search settings
www/src/components/navigation/Search.tsx - Documentation search → Algolia DocSearch: opens search
www/src/components/navigation/Search.tsx - Documentation visitor → Open Graph route: requests image
- Open Graph route → Open Graph renderer: renders image layout
www/src/pages/og.ts - Open Graph route → Site and docs config: reads defaults
www/src/pages/og.ts - Open Graph route → Language helpers: resolves language
www/src/pages/og.ts - Open Graph route → OG font loader: loads fonts
www/src/pages/og.ts - Open Graph route → Site URL helper: uses site URL
www/src/pages/og.ts - Language helpers → Site and docs config: uses language types
www/src/languages.ts