Cursor rule

1---
2description: "Frontend development rules for React 18, Electron, ShadCN UI, and Tailwind CSS."
3globs: "sdk/**/*.tsx,sdk/**/*.ts,sdk/**/*.jsx,sdk/**/*.js"
4alwaysApply: false
5---
6 
7# Frontend React Rules
8 
9These rules apply when working on frontend code in `sdk/`.
10 
11## Technology Stack
12 
13- **Framework**: React 18
14- **Desktop**: Electron
15- **UI Library**: ShadCN UI components
16- **Styling**: Tailwind CSS
17- **Type Safety**: TypeScript (strict mode)
18 
19## Component Patterns
20 
21- Use functional components with hooks (no class components)
22- Use TypeScript interfaces for all props
23- Follow ShadCN UI component patterns for consistency
24- Use Tailwind utility classes for styling (avoid custom CSS)
25 
26### Authenticated Pages
27 
28For pages requiring authentication, see `patterns_library/ui/authenticated-page.md`.
29 
30### Forms
31 
32For forms with validation, see `patterns_library/ui/form-with-validation.md` (React Hook Form + Zod).
33 
34### Data Tables
35 
36For paginated data tables, see `patterns_library/ui/data-table.md`.
37 
38## State Management
39 
40- Use React hooks for local state
41- Use context for shared state within feature boundaries
42- Avoid prop drilling beyond 2 levels
43 
44## API Integration
45 
46- All API calls must handle loading, error, and success states
47- Use proper error boundaries so analytics/API failures do not crash the app
48- Handle authentication token refresh transparently
49 
50## Accessibility
51 
52- All interactive elements must be keyboard-navigable
53- Use semantic HTML elements
54- Include ARIA labels where needed
55- Follow ShadCN UI's built-in accessibility patterns
56 
57## Validation Commands
58 
59```bash
60# TypeScript validation
61{{TYPE_CHECK_COMMAND}}
62 
63# Linting
64{{LINT_COMMAND}}
65 
66# Build verification
67{{BUILD_COMMAND}}
68```
69 
70## Key References
71 
72- See `patterns_library/ui/` for UI component patterns
73- See `docs/security/SECURITY_FIRST_ARCHITECTURE.md` for client-side security
74- See `CONTRIBUTING.md` for full workflow details
75