Skip to content

AGENTS.md

Latest commit

 

History

History
24 lines (20 loc) · 1.03 KB

AGENTS.md

File metadata and controls

24 lines (20 loc) · 1.03 KB
description
alwaysApply false

AGENTS.md — flavitars

Commands

  • Dev: bun dev
  • Build: bun build — always run after changes
  • Lint: bun lint (eslint) — always run after changes

Architecture

Next.js 16 with React 19 and App Router. Standard structure: app/ (routes), components/ (UI), hooks/, lib/ (utilities). Uses React Compiler (babel-plugin-react-compiler).

Code Style

  • Comments: Do not add “helpful” comments on variables or obvious code — especially block comments above let/const that restate names. Prefer clear names. Comment only for non-obvious why (invariants, quirks, perf).
  • Package manager: Bun
  • Types: Strict TypeScript; prefix unused vars with _; any is a warning
  • Components: Radix UI primitives, shadcn/ui, CVA for variants, Tailwind CSS 4
  • Formatting: ESLint with Next.js config; follow existing patterns in codebase
  • Validation: Zod for schemas
  • State: nuqs for URL search params
  • Errors: Avoid unescaped entities in JSX