Cursor rule

1---
2description: File structure guidelines for NOWCRM
3globs: []
4alwaysApply: true
5---
6# File Structure Guidelines
7 
8## Directory Organization
9```
10apps/nowcrm/
11├── components/     # Reusable UI components
12├── app/            # Route components  
13├── i18n/           # I18N configuration
14├── lib/            # Handling server actions and different utils
15├── hooks/          # Custom hooks
16├── types/          # Type definitions
17└── messages/       # I18N jsons for each language
18 
19apps/composer/src/
20├── api/            # Api routes
21├── api-docs/       # Handling api routes setup
22├── common/         # Common and reused utils
23├── lib/            # Functions, types and workers
24└── scheduler/      # Scheduler which are integrated with composer calendar
25 
26apps/journeys/src/
27├── api/            # Handling webhooks api routes for journeys
28├── common/         # Common and reused utils
29├── consumers/      # All journeys consumers setup
30├── cron/           # Cron jobs which acts as a producer to create new jobs
31├── jobs/           # All job configuration
32├── lib/            # Functions, types and workers
33└── rabbitmq/       # Rabbitmq setup
34```
35 
36## File Naming
37- **kebab-case** for all files and directories
38- **Descriptive suffixes** for clarity
39```
40// ✅ Correct naming
41user.tsx
42user.component.tsx
43user.service.ts
44user.test.tsx
45```
46 
47## Index Files & Barrel Exports
48```typescript
49// ✅ Clean barrel exports in index.ts
50export { UserCard } from './user-card.component';
51export { UserList } from './user-list.component';
52export type { UserCardProps, UserListProps } from './types';
53 
54// ✅ Usage - clean imports
55import { UserCard, UserList } from '@/components/user';
56```
57 
58## File Size Guidelines
59- **Components**: Under 300 lines if possible
60- **Services**: Under 500 lines if possible
61- **Extract logic** into hooks/utilities when files grow large
62- **Use composition** over large monolithic components
63 
64## Configuration Files
65 
66### Project Configuration
67```
68.vscode/                       # VSCode settings
69├── settings.json
70├── extensions.json
71└── launch.json
72 
73.github/                       # GitHub workflows
74├── workflows/
75└── templates/
76 
77.cursor/                       # Cursor rules
78├── rules/
79└── environment.json
80```
81 
82### Build Configuration
83- Keep build configs in root or package directories
84- Use consistent naming for config files
85- Comment complex configurations
86- Version control all configuration files