typescript-monorepo

name: typescript-monorepo description: Use when adding or changing packages/apps, TypeScript configs, workspace dependencies, package references, exports, or monorepo project-reference relationships.

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 tsgo and runs through moon: moonx <project>:typecheck (moon builds workspace dependencies first, since types resolve through each dependency's built dist).

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 and the bun toolchain.

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 dependency 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.