Project

A generated repo is a pnpm workspace with Turborepo. Workspace globs are apps/*, packages/*, and tooling/*.

Layout

my-app/
├── .env.example          # always; copy to .env
├── .gitignore
├── .npmrc                # engine-strict=true
├── package.json
├── pnpm-workspace.yaml
├── turbo.json
├── README.md
├── apps/
│   ├── vite/             # optional Vite (framework chosen in the CLI)
│   ├── next/             # optional Next.js
│   ├── astro/            # optional Astro
│   ├── expo/             # optional Expo Router
│   ├── electron/         # optional Electron + Vite
│   ├── express/          # optional Express
│   ├── fastify/          # optional Fastify
│   ├── tanstack-start/   # optional TanStack Start
│   └── react-router/     # optional React Router
├── packages/
│   ├── env/              # always
│   ├── ui/               # optional shadcn/ui
│   ├── api/              # optional tRPC
│   ├── auth/             # optional, when an auth provider is selected
│   ├── db/               # optional, when Drizzle or Prisma is selected
│   ├── payments/         # optional, when Stripe, Polar, or Autumn is selected
│   └── email/            # optional, when Resend is selected
└── tooling/
    ├── tsconfig/         # always
    ├── tailwind/         # optional
    ├── oxc/              # optional
    ├── prettier/         # optional stub
    └── eslint/           # optional stub

App folder names are whatever you typed (after sanitizing), not the type names above.

.gitignore

The root .gitignore is generated from the apps, tooling, and database dialect you selected. Workspace entries are always present: node_modules, dist, .turbo, **/.cache/, *.log, .env, and .env.local.

Stack-specific paths are added only when that choice is on:

Selection	Entries
Next.js	.next, out
Astro	.astro
Expo Router	.expo, expo-env.d.ts, web-build
Electron + Vite	release
TanStack Start	.output, .nitro, .tanstack
React Router	.react-router, build
ESLint	.eslintcache
Prettier	.prettiercache
Drizzle + SQLite	*.db, *.db-journal, *.db-wal, *.db-shm

Vite, Express, Fastify, shadcn/ui, tRPC, auth, payments, email, PostgreSQL/MySQL Drizzle, Prisma, Tailwind, and Oxc do not add extra ignore paths — they use dist, .env, or node_modules already listed in the workspace section. Drizzle + SQLite also ignores *.db, *.db-journal, *.db-wal, and *.db-shm. Astro build output is dist; only the generated .astro types directory is extra.

Root scripts

Script	What it runs
pnpm dev	turbo run dev
pnpm build	turbo run build
pnpm lint	turbo run lint, or repo-wide Oxc if you selected Oxc
pnpm format	turbo run format, or repo-wide Oxc format if you selected Oxc
pnpm check-types	turbo run check-types
pnpm test	turbo run test

Turbo dev is uncached and persistent. check-types depends on ^build. Env vars from packages/env are listed on turbo.json globalEnv (except NODE_ENV).

Workspace package scopes

Workspace packages use only the scope that matches their top-level folder:

Folder	Package name and import pattern
apps/<name>	@apps/<name>
packages/<name>	@packages/<name>
tooling/<name>	@tooling/<name>

The project name is never used as a package scope. For example, a project named my-app imports its database package from @packages/db, not @my-app/db. Use the same names with pnpm filters and in workspace dependencies.

Package manager

Install and run scripts with pnpm. The generated package.json pins packageManager to pnpm@11.2.2 when you scaffolded with pnpm. Node is declared as >=22 (engine-strict is on).

Filter a single package:

pnpm --filter @apps/next dev
pnpm --filter @packages/db db:studio