typescript-monorepo

TypeScript Monorepo

TypeScript

Use TypeScript everywhere practical. Compiler settings are intentionally fairly strict.

• Shared compiler options live in tsconfig.options.json.
• Root tsconfig.json manages project references across the monorepo.
• Typechecking uses TypeScript 7's native tsc (the successor to the tsgo preview) and runs through moon: moonx <project>:typecheck (moon builds workspace dependencies first, since types resolve through each dependency's built dist). Next runs the same tsc for its build-time check through experimental.useTypeScriptCli, which is on by default since Next 16.3.

Project References

When adding a new package or app:

• Add it to the root tsconfig.json references.
• Ensure its local tsconfig.json follows existing package/app patterns.
• Give it a moon.yml (language, layer, tags, and any project-specific tasks); shared tasks come from .moon/tasks/*.yml via tags or project language.

When one workspace package depends on another:

• Add the dependency as workspace:* in the consuming package.
• Add the dependency to the consuming package's TypeScript references block when needed for accurate and fast typechecking.

Workspace Dependencies

Use the pnpm-workspace.yaml catalog rules from tooling-and-dependencies for external packages. Use workspace:* for internal package dependencies.

If a package is published, review its exports, typesVersions, files, peer dependencies, and its moon prepublish task chain before changing public entrypoints or dependency ranges.