Resunova Web

Next.js frontend for Resunova: Analyze, Tailor, Template Builder, Resume Hub, Advisor dashboard.

Doc	Purpose
AGENTS.md	Frontend conventions — read before editing
CONTRIBUTING.md	Local dev for employees (API is remote)
docs/api-contract.md	REST API shapes the UI depends on

Local dev

Requires Node ≥20.9.

npm install
npm run dev

Create .env.local:

NEXT_PUBLIC_API_URL=https://your-api.up.railway.app
NEXT_PUBLIC_DEV_BYPASS_AUTH=true
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=...

Open http://localhost:3000.

Most contributors use the remote Railway API — the NLP backend is in a separate private repository.

Deploy

Pushes to main trigger .github/workflows/deploy.yml → GitHub Pages (www.resunova.io).

Required GitHub Actions secrets: RAILWAY_API_URL, SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY.

Key paths

• app/ — Next.js App Router
• components/ — Feature UI (AnalyzeResume, ResumeBuilder, …)
• hooks/ — useHtmlPdfExport, analyze export, etc.
• lib/ — API helpers, Supabase client, analysisCategoryMatch.ts
• store/ — Zustand state
• db/migrations/ — Supabase SQL migrations

Typecheck

npx tsc --noEmit