Cursor rule

1---
2globs: packages/strapi-plugin-*/**
3alwaysApply: false
4---
5# Strapi Plugin Development Guide
6 
7## Plugin Structure
8 
9Follow the pattern established in [packages/strapi-plugin-status-manager/](mdc:packages/strapi-plugin-status-manager/):
10 
11```
12packages/strapi-plugin-[name]/
13├── admin/src/           # Frontend components
14├── server/src/          # Backend logic
15├── package.json         # Plugin configuration
16├── rollup.config.mjs    # Build configuration
17└── README.md           # Documentation
18```
19 
20## Package Configuration
21 
22Use proper exports for Strapi 5:
23 
24```json
25{
26  "exports": {
27    "./strapi-admin": {
28      "source": "./admin/src/index.ts",
29      "import": "./dist/admin/index.mjs",
30      "require": "./dist/admin/index.js"
31    },
32    "./strapi-server": {
33      "source": "./server/src/index.ts", 
34      "import": "./dist/server/index.mjs",
35      "require": "./dist/server/index.js"
36    }
37  }
38}
39```
40 
41## Server-Side Structure
42 
43- **Index**: [packages/strapi-plugin-status-manager/server/src/index.ts](mdc:packages/strapi-plugin-status-manager/server/src/index.ts) - Main plugin export
44- **Controllers**: Handle API requests
45- **Services**: Business logic
46- **Routes**: API endpoint definitions
47- **Middlewares**: Request processing
48- **Bootstrap**: Initialization logic
49 
50## Admin-Side Structure
51 
52- **Index**: Main admin export
53- **Components**: React components for admin UI
54- **Plugin ID**: Unique identifier for the plugin
55 
56## Development Workflow
57 
581. **Build**: `npm run build` (compiles TypeScript)
592. **Dev Mode**: `npm run dev` (watch mode)
603. **Test**: `npm run test:debug` (manual testing)
614. **Restart**: Strapi server restart required for server changes
62 
63## Plugin Registration
64 
65Register in [apps/backend/config/plugins.ts](mdc:apps/backend/config/plugins.ts):
66 
67```typescript
68'primer-status-manager': {
69  enabled: true,
70}
71```
72 
73## Debugging
74 
75- Use console.log with emoji prefixes for easy identification
76- Check Strapi logs for plugin loading
77- Test endpoints manually with debug scripts
78- Verify routes are properly registered
79 
80## Build Process
81 
82- TypeScript compilation to `dist/`
83- Rollup bundling for admin components
84- Separate builds for server and admin
85- Proper source maps for debugging