📄 tanstack/config/latest/docs/package-structure
File: package-structure.md | Updated: 11/15/2025
Source: https://tanstack.com/config/latest/docs/package-structure
Search...
+ K
Auto
Docs Examples GitHub Contributors
Docs Examples GitHub Contributors
Docs Examples GitHub Contributors
Docs Examples Github Contributors
Docs Examples Github Contributors
Docs Examples Github Contributors
Docs Examples Github Contributors
Docs Examples Github Contributors
Maintainers Partners Support Learn StatsBETA Discord Merch Blog GitHub Ethos Brand Guide
Documentation
Version
Latest
Search...
+ K
Menu
Getting Started
Utilities
Conventions
Version
Latest
Menu
Getting Started
Utilities
Conventions
On this page
Package Structure
Copy Markdown
The following structure ensures packages work optimally with our monorepo/Nx workflow.
- All TanStack projects have "type": "module" to set the default resolution of .js files to ESM; this does not have any impact on building for CJS
- It is also essential to have an "exports" field
- For legacy reasons, you should also include the "main", "module", and "types" fields
- All packages have the following scripts which are cached by Nx: "test:eslint", "test:types", "test:lib", "build", "test:build"
- Extends the root-level tsconfig (e.g. "extends": "../../tsconfig.json")
- Add any framework-specific options and included files here
- Includes config for Vitest, and for Vite if @tanstack/config/vite is used
- This folder should only include code which gets built and shipped to users
- Tests should not be placed in this folder, as they bloat the shipped code, and can unintentionally invalidate the Nx cache
- This folder should include all test files
- It should also include any test setup files required by that framework
