Cursor rule

1---
2alwaysApply: true
3---
4# Monorepo Management Guide
5 
6## Workspace Structure
7 
8Primer uses npm workspaces defined in [package.json](mdc:package.json):
9 
10- **Apps**: `apps/*` - Main applications (backend, frontend)
11- **Packages**: `packages/*` - Shared packages and plugins
12- **CLI**: `cli` - Command-line tools
13 
14## Build System
15 
16**Turborepo** orchestrates builds across workspaces:
17 
18- **Configuration**: [turbo.json](mdc:turbo.json)
19- **Caching**: Build cache for faster subsequent builds
20- **Parallel Execution**: Run tasks across workspaces simultaneously
21 
22## Package Management
23 
24### Shared Dependencies
25 
26- **ESLint Config**: [packages/eslint-config-primer/](mdc:packages/eslint-config-primer/)
27  - Base config for all packages
28  - Client-specific config for frontend
29  - Server-specific config for backend
30 
31### Plugin Packages
32 
33- **Status Manager**: [packages/strapi-plugin-status-manager/](mdc:packages/strapi-plugin-status-manager/)
34- **Product Actions**: [packages/strapi-plugin-product-actions/](mdc:packages/strapi-plugin-product-actions/)
35 
36## Development Commands
37 
38### Root Level Commands
39 
40- `yarn dev` - Start all services
41- `yarn backend` - Start only backend
42- `yarn frontend` - Start only frontend
43- `yarn test` - Run all tests
44- `yarn lint` - Lint all packages
45- `yarn clean` - Clean all build artifacts
46 
47### Workspace-Specific Commands
48 
49Each workspace has its own scripts defined in their `package.json`.
50 
51## Dependency Management
52 
53### Scripts
54 
55- **Dependency Management**: [scripts/upgrade-deps.js](mdc:scripts/upgrade-deps.js)
56 
57### Version Management
58 
59- Use `template-version.json` for version tracking
60- Shared dependencies managed at root level
61- Workspace-specific dependencies in individual packages
62 
63## Build Artifacts
64 
65- **Backend**: `apps/backend/dist/` - Compiled Strapi code
66- **Frontend**: `apps/frontend/.next/` - Next.js build
67- **Plugins**: `packages/*/dist/` - Compiled plugin code
68- **Coverage**: `coverage/` - Test coverage reports
69 
70## Best Practices
71 
72- Keep shared dependencies at root level
73- Use workspace references for internal packages
74- Maintain consistent versioning across packages
75- Use Turborepo for efficient builds
76- Follow consistent naming conventions