Cursor rule

1---
2description: Core QBook stack, structure, agent behavior, and git policy
3alwaysApply: true
4---
5 
6# QBook — Core Rules
7 
8## Stack
9- Next.js 16, App Router (no `src/` directory)
10- App routes at `app/`, UI components at `components/`
11- Tailwind 4, shadcn/Base UI
12- `next-themes` for dark mode (light + dark must receive equal attention)
13- TypeScript strict mode
14- Vercel deployment (push to main = auto-deploy to production)
15 
16## Coding Style
17- Functional components only — no class components
18- Prefer server components unless interactivity is needed
19- One primary CTA per view (filled); secondary actions = outline/ghost
20- Use existing design tokens from `app/globals.css` (`.qbook-type-*` scale)
21- Geist UI font + Quicksand wordmark only
22 
23## Git Workflow
24- Do NOT commit or push unless I explicitly ask or I run `/ship`
25- Do NOT create branches or PRs unless I explicitly ask
26- Use conventional commits: `type(scope): description`
27- Do NOT use em-dashes or non-ASCII characters in commit messages
28- Do NOT use PowerShell redirection operators (`>`, `>>`) — they produce UTF-16
29- If a git hook or push fails, STOP and tell me. Do NOT retry or attempt to fix hooks.
30- When `/ship` or I ask to commit: combine staging, committing, and pushing when possible:
31  `git add -A && git commit -m "<message>" && git push`
32 
33## Agent Behavior
34- Keep tasks scoped and incremental — do not refactor entire files unprompted
35- If a command fails, stop and report. Do NOT enter retry loops.
36- Prefer `@file` references over `@codebase` for targeted context
37- When creating new components, follow existing patterns in `components/`
38 
39## File Structure Reference
40- Foundations: `app/globals.css`, `app/(app)/layout.tsx`
41- Shared components: `components/shared/`
42- Booking components: `components/bookings/`
43- Calendar: `components/calendar/`
44- Profile: `components/profile/`
45- Document/Print shell: `app/(document)/`
46- UX spec: `docs/FRONTEND_UX_SPEC.md`
47