Cursor rule

1---
2description: Rules for working in the Dashboard (React frontend)
3globs: apps/dashboard/**/*
4alwaysApply: false
5---
6 
7## Dashboard
8 
9**Stack:** React 19 + Vite + TypeScript · Radix UI · Tailwind CSS · shadcn/ui · TanStack Query · React Router · motion/react · port 4201
10 
11**Run:** Do not build or start the dashboard — the user already has it running on port 4201. Check types via Cursor diagnostics.
12 
13**Tests/lint:** see testing.mdc
14 
15**Key directories:**
16```
17apps/dashboard/src/components/   # Shared UI components
18apps/dashboard/src/pages/        # Route-level page components
19apps/dashboard/src/hooks/        # Custom React hooks
20apps/dashboard/src/api/          # API client and query definitions
21apps/dashboard/src/ee/           # Enterprise-only features
22```
23 
24**Agent sign-in:** A default user and org are pre-seeded. In Cursor cloud agent environments (`apps/dashboard/.env.agent`), the dashboard auto signs in — open `http://localhost:4201` and wait for redirect; do not type credentials unless auto sign-in fails.
25 
26| Field | Value |
27|-------|-------|
28| Email | `agent@novu.co` |
29| Password | `Agent123!@#` |
30| Organization | `Agent Organization` |
31 
32---
33 
34### Dashboard Conventions
35 
36**Data fetching**
37- Use TanStack Query (`useQuery`, `useMutation`) for all server state — do not use `useEffect` + `fetch` directly.
38- Co-locate query keys and fetcher functions in `src/api/` or alongside the feature they belong to.
39- Invalidate related queries after mutations; do not manually update the cache unless necessary for optimistic UI.
40 
41**UI components**
42- Build on Radix UI primitives and the existing shadcn/ui component set in `src/components/ui/`.
43- Avoid adding new third-party UI libraries without discussion.
44- Use Tailwind utility classes for all styling; avoid inline `style` props except for dynamic values that cannot be expressed as utilities.
45 
46**Routing**
47- Use React Router v6 `<Link>` and `useNavigate` — do not use `window.location` for in-app navigation.
48 
49**Canonical example:** @apps/dashboard/src/components/environments/edit-environment-sheet.tsx
50