> For the complete documentation index, see [llms.txt](https://gotts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gotts.gitbook.io/docs/monorepo-infrastructure/monorepo.md).

# Index

> **Scope**: Repository-wide tooling and configuration | **Last Updated**: 2026-02-19 | **Parent Index**: [`prd/README.md`](/docs/prd-product-requirements/prd.md)
>
> Canonical specification for the Gotts monorepo foundation: package management, build tooling, TypeScript configuration, testing, linting, publishing, frontend stack, and developer experience. All configuration is designed to be copy-pasteable and production-ready.

***

## PRD Files

| #  | File                                                                                | Topic                                                                                  |
| -- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 01 | [01-overview.md](/docs/monorepo-infrastructure/monorepo/01-overview.md)             | Executive summary, goals, non-goals, yarn → pnpm migration rationale                   |
| 02 | [02-architecture.md](/docs/monorepo-infrastructure/monorepo/02-architecture.md)     | Directory structure, package dependency graph, Turborepo config, workspace layout      |
| 03 | [03-typescript.md](/docs/monorepo-infrastructure/monorepo/03-typescript.md)         | TypeScript 5.8+ configs, shared config package, tsx runner, key decisions              |
| 04 | [04-build-test.md](/docs/monorepo-infrastructure/monorepo/04-build-test.md)         | tsdown for published packages, internal packages pattern, Vitest 4.0+ config, coverage |
| 05 | [05-lint-format.md](/docs/monorepo-infrastructure/monorepo/05-lint-format.md)       | ESLint 10 flat config, Prettier 3.5+, perfectionist, pre-commit hooks                  |
| 06 | [06-publishing.md](/docs/monorepo-infrastructure/monorepo/06-publishing.md)         | `@gotts.ai` npm scope, Changesets, package.json exports, provenance, release workflow  |
| 07 | [07-frontend.md](/docs/monorepo-infrastructure/monorepo/07-frontend.md)             | Next.js 15.5+/16, Tailwind v4 CSS-first config, shadcn/ui, shared UI package           |
| 08 | [08-dx-ci.md](/docs/monorepo-infrastructure/monorepo/08-dx-ci.md)                   | VS Code config, GitHub Actions CI, Knip, Syncpack, Renovate, clean scripts             |
| 09 | [09-implementation.md](/docs/monorepo-infrastructure/monorepo/09-implementation.md) | 4-phase rollout plan, success metrics, risks and mitigations                           |
| 10 | [10-appendix.md](/docs/monorepo-infrastructure/monorepo/10-appendix.md)             | Complete file listing of every config file with full copy-pasteable contents           |

## Key Decisions

| Decision        | Choice                   | Rationale                                                                  |
| --------------- | ------------------------ | -------------------------------------------------------------------------- |
| Package manager | pnpm 9.x (from yarn 4.x) | Strict dependency isolation, faster installs, native workspace support     |
| Task runner     | Turborepo 2.8+           | Remote caching, task graph, watch mode, Rust-powered performance           |
| Build tool      | tsdown (from tsup)       | Active successor to tsup (deprecated), Rolldown-powered, same DX           |
| Linter          | ESLint 10 flat config    | Legacy eslintrc removed, native flat config only                           |
| CSS framework   | Tailwind v4 CSS-first    | No `tailwind.config.js`, CSS `@theme` directives, native cascade layers    |
| Test runner     | Vitest 4.0+              | Root `projects` config (deprecated `vitest.workspace` removed)             |
| npm scope       | `@gotts.ai`              | Brand-aligned, available on npm                                            |
| TypeScript      | 5.8+ (bundler)           | `--erasableSyntaxOnly` for Node.js strip-types, `bundler` for all packages |

## Related PRDs

* [Vault PRD](/docs/gotts-vaults/vault.md) — Gotts Vaults (ERC-4626 + ERC-8004)
* [MCP Server PRD](/docs/gotts-safe-mcp-server/mcp-server.md) — Gotts Safe (147 tools)
* [Skills PRD](/docs/skills/skills.md) — User-facing skill definitions
* [Agents PRD](/docs/agents/agents.md) — Autonomous agent specifications
* [Devenv PRD](/docs/devenv/devenv.md) — Local Uniswap development environment
* [Shared Docs](https://github.com/wpank/gotts.ai-monorepo/blob/main/prd/shared/README.md) — Cross-cutting references (glossary, chains, safety layers)