adilalloCommunity Rule
A Next.js application for community decision-making and governance documentation.
Requirements
- Node.js 20+ (LTS)
- npm 10+
Getting started
npm ci
npm run dev
Open http://localhost:3000.
Backend setup (Postgres, Prisma, magic-link auth) is documented in CONTRIBUTING.md.
Common scripts
| Command | What it does |
|---|---|
npm run dev |
Next.js dev server (Turbopack). |
npm run build / npm start |
Production build / serve. |
npm test |
Vitest unit + component tests with coverage. |
npm run test:component |
Faster inner loop — components only. |
npm run e2e |
Playwright E2E + visual regression. |
npm run storybook |
Storybook on port 6006. |
npm run lhci |
Lighthouse CI performance pass. |
Project layout
app/ Next.js app router: route groups (marketing), (app), (admin), (dev);
shared components under app/components/; optional _components/
colocated with a route (e.g. (admin)/monitor/_components/)
lib/ Shared library code (i18n, validation, utilities)
messages/en/ Localized UI copy (see docs/guides/i18n-translation-workflow.md)
prisma/ Database schema, migrations, seed
public/ Static assets
stories/ Storybook stories
tests/ Vitest + Playwright suites
docs/ User-facing documentation (start with docs/README.md)
.cursor/rules/ Implementation conventions enforced by Cursor
Tech stack
Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Prisma · Vitest · Playwright · Storybook 10 · Lighthouse CI.
Documentation
- docs/README.md — index of guides and rules.
- docs/create-flow.md — create-rule wizard canon.
- docs/testing-guide.md — testing philosophy.
- CONTRIBUTING.md — local backend, API routes, PR workflow.
License
MIT.