Skip to main content

NPM-Helper-App

HR + payroll application.

Getting started

# 1. Install Node 24 (use nvm or volta)
nvm use

# 2. Install pnpm if you don't have it
npm i -g pnpm

# 3. Install deps + git hooks
pnpm install

# 4. Copy env template
cp .env.example .env.local

# 5. Run
pnpm dev

Alternatively: open in VS Code and choose "Reopen in Container" for a fully reproducible environment.

Scripts

CommandWhat it does
pnpm devStart dev server
pnpm buildProduction build
pnpm checkLint + format + organize imports
pnpm typecheckTypeScript with no emit
pnpm testRun Vitest

Architecture

See CLAUDE.md for conventions and docs/adr/ for architecture decisions.