# CLAUDE.md

Frontend for the HRMS monorepo. Source lives in this directory (`hrms-frontend/`). Do not use the standalone GitHub repo `https://github.com/Jumppaceorg/hrms-frontend`.

## Commands

**Package manager: `pnpm`**

```bash
pnpm dev       # Dev server on port 3000
pnpm build     # Production build
pnpm start     # Production server
pnpm check     # Biome lint + format
pnpm test      # Vitest
```

## Stack

- Next.js 15 App Router (`src/app/`)
- React 19, TypeScript
- RTK Query (`src/lib/store/hrms-api/`)
- NextAuth, shadcn/ui, Tailwind CSS, Biome

## Conventions

- Authenticated routes: `src/app/(app)/`
- Permission guard: `useRequirePermissions(["permission.key"], "/")`
- Imports: `@/` → `src/`
- Listing tables: `@/components/ui/data-table`
- Canonical listing page: `src/app/(app)/employees/page.tsx`