Name: project-best-practices
Author: hanzlah101

Instruction file imported from hanzlah101/mehfil (.cursor/rules/project-best-practices.mdc). Copyright stays with the author.

TypeScript strict: tsconfig.json keeps strict: true, verbatimModuleSyntax, and path aliases (@/*, @db/*) so every module resolves with full type safety.
Lint-first workflow: eslint.config.ts enforces React + Hooks rules, consistent type-only imports, and treats unused identifiers as errors unless they’re prefixed with _.
Prettier + Tailwind order: prettier.config.mjs runs prettier-plugin-tailwindcss with project-specific utility lists to auto-sort classes and keep CSS atomic.
Design system primitives: reusable, accessible UI lives in app/components/ui/*, built on Radix primitives, class-variance-authority, and tailwind-merge to keep variants declarative.
Domain-scoped modules: features such as events, meals, staff, and venues each keep their forms, dialogs, and lists under app/components/<feature> plus matching Zustand stores in app/stores.
Schema-driven forms: Zod schemas in app/validations/* pair with @tanstack/react-form hooks (app/hooks/form-hooks.tsx) so validation, defaults, and submission share a single source of truth.
Auth + data providers: app/providers/convex-provider.tsx composes Convex, BetterAuth, and React Query clients with toast-based error handling, ensuring every screen shares caching + auth state.
Utility-first helpers: cross-cutting helpers in app/lib/* (cn, date formatters, permissions, constants) centralize business rules so components stay presentational.

{ "ocm": "1", "id": "hanzlah101-mehfil-project-best-practices-rule", "kind": "skill", "name": "project-best-practices", "description": "`TypeScript strict`: `tsconfig.json` keeps `strict: true`, `verbatimModuleSyntax`, and path aliases (`@/*`, `@db/*`) so every module resolves with full type safety. - `Lint-first workflow`: `eslint.config.ts` enforces React + Hooks rules, consistent type-only imports, and treats unused identifiers as errors unless they’re prefixed with `_`. - `Prettier + Tailwind order`: `prettier.config.mjs` runs `prettier-plugin-tailwindcss` with project-specific utility lists to auto-sort classes and keep CSS atomic. - `Design system primitives`: reusable, accessible UI lives in `app/components/ui/*`, built on Radix primitives, `class-variance-authority`, and `tailwind-merge` to keep variants declarative. - `Domain-scoped modules`: features such as events, meals, staff, and venues each keep their forms, dialogs, and lists under `app/components/<feature>` plus matching Zustand stores in `app/stores`. - `Schema-driven forms`: Zod schemas in `app/validations/*` pair with `@tanstack/react-form` hooks (`app/hooks/form-hooks.tsx", "publisher": "hanzlah101", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-cursor-rules" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "`TypeScript strict`: `tsconfig.json` keeps `strict: true`, `verbatimModuleSyntax`, and path aliases (`@/*`, `@db/*`) so every module resolves with full type safety. - `Lint-first workflow`: `eslint.config.ts` enforces React + Hooks rules, consistent type-only imports, and treats unused identifiers as errors unless they’re prefixed with `_`. - `Prettier + Tailwind order`: `prettier.config.mjs` runs `prettier-plugin-tailwindcss` with project-specific utility lists to auto-sort classes and keep CSS atomic. - `Design system primitives`: reusable, accessible UI lives in `app/components/ui/*`, built on Radix primitives, `class-variance-authority`, and `tailwind-merge` to keep variants declarative. - `Domain-scoped modules`: features such as events, meals, staff, and venues each keep their forms, dialogs, and lists under `app/components/<feature>` plus matching Zustand stores in `app/stores`. - `Schema-driven forms`: Zod schemas in `app/validations/*` pair with `@tanstack/react-form` hooks (`app/hooks/form-hooks.tsx" ], "primary": false, "metadata": { "source": { "provider": "github-cursor-rules", "repository": "https://github.com/hanzlah101/mehfil", "path": ".cursor/rules/project-best-practices.mdc", "ref": "ac5fa7811df81d19506b7a9f7591048eb0f65b1b", "url": "https://github.com/hanzlah101/mehfil/blob/ac5fa7811df81d19506b7a9f7591048eb0f65b1b/.cursor/rules/project-best-practices.mdc", "key": "hanzlah101/mehfil/.cursor/rules/project-best-practices.mdc" } }, "instructions": "- `TypeScript strict`: `tsconfig.json` keeps `strict: true`, `verbatimModuleSyntax`, and path aliases (`@/*`, `@db/*`) so every module resolves with full type safety.\n- `Lint-first workflow`: `eslint.config.ts` enforces React + Hooks rules, consistent type-only imports, and treats unused identifiers as errors unless they’re prefixed with `_`.\n- `Prettier + Tailwind order`: `prettier.config.mjs` runs `prettier-plugin-tailwindcss` with project-specific utility lists to auto-sort classes and keep CSS atomic.\n- `Design system primitives`: reusable, accessible UI lives in `app/components/ui/*`, bui", "cost": { "context_tokens": 368 } }

project-best-practices

About

Use it

Manifest

Reviews