Baseleg Docs

ADR-003: Monorepo tooling

Date: 2026-04-28 Status: Accepted

Context

We need a maintainable monorepo setup that supports multiple apps and many small packages with fast local iteration and CI caching.

Decision

  • Use pnpm workspaces for dependency management.
  • Use Turborepo for task orchestration and caching.

Consequences

  • Standard scripts exist for build/dev/lint/typecheck/test/format/docs.
  • Packages should remain small and focused to keep dependency graph healthy.

Alternatives considered

  • npm workspaces (slower installs for large graphs)
  • Yarn workspaces
  • Nx (more opinionated than needed initially)