Petru Paler
3567fbafd7
Some checks failed
Deploy / deploy (push) Failing after 6m37s
POCKETBASE_URL was only available server-side, causing the login page to fall back to localhost:8090 in the browser. Renamed to NEXT_PUBLIC_POCKETBASE_URL so Next.js bundles it into client code. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
ABOUTME: Operational notes for Ralph autonomous development loops.
ABOUTME: Contains build/test commands and codebase patterns specific to PhaseFlow.
Build & Run
- Dev server:
pnpm dev - Build:
pnpm build - Start production:
pnpm start
Validation
Run these after implementing to get immediate feedback:
- Tests:
pnpm test:run - Lint:
pnpm lint - Lint fix:
pnpm lint:fix - Typecheck:
pnpm tsc --noEmit
Operational Notes
- Database: PocketBase at
NEXT_PUBLIC_POCKETBASE_URLenv var - Garmin tokens encrypted with AES-256 using
ENCRYPTION_KEY(32 chars) - Path aliases:
@/*maps to./src/* - Pre-commit hooks: Biome lint + Vitest tests via Lefthook
Codebase Patterns
- TDD required: Write tests before implementation
- All files start with 2-line ABOUTME comments
- No mock mode: Use real data and APIs only
- Never use
--no-verifyfor git commits - Commit format: Descriptive message + Claude footer
Tech Stack
| Layer | Choice |
|---|---|
| Framework | Next.js 16 (App Router) |
| Runtime | Node.js 24 |
| Database | PocketBase |
| Validation | Zod |
| Testing | Vitest + jsdom |
| Linting | Biome |
File Structure
src/app/- Next.js pages and API routessrc/components/- React UI componentssrc/lib/- Business logic utilitiessrc/types/- TypeScript type definitionsspecs/- Feature specifications for Ralph