| name | nx-project-configurator |
| description | Use when configuring NX monorepo projects and dependency rules |
NX Project Configurator
Dependency Rules
- apps/* NEVER import from other apps/*
- libs/* NEVER import from apps/*
- apps/web → libs/ui, libs/shared-types
- apps/api → libs/db, libs/python-common
- apps/mcp-server → libs/python-common
- libs/db → libs/python-common
Workspace Layout
{
"targetDefaults": {
"build": { "dependsOn": ["^build"] },
"test": { "dependsOn": ["build"] }
}
}
Root package.json Workspaces
{
"workspaces": ["apps/web", "libs/ui", "libs/shared-types"]
}
Adding a New Project
- Create directory under apps/ or libs/
- Add package.json or pyproject.toml
- Verify:
npx nx graph shows correct dependencies
- Add to workspace array if TypeScript
References
- nx.json: project root
- package.json: project root
- tsconfig.base.json: project root