PunProfile App

The web surface of PunProfile Career Coaching. EU Fit Check is its assessment feature, not the product itself; the job board, saved jobs and application tracker are specified in Phase 4.

All specifications live in the sibling repo ../punprofile-career-coaching/: the method in 10_Methodology.md, the product specs in ctxt-product/, the roadmap in punprofile-work/work-projects/eu-fit-check/. This repo is implementation only. See AGENTS.md.

Getting Started

npm install
npm run dev

Open http://localhost:3000.

Environment Variables

Copy .env.example to .env.local and fill in real values. See docs/prd.md § 2 Technical Architecture for what each service is for.

Variable	Where it's used	Notes
NEXT_PUBLIC_CONVEX_URL	Next.js client	Convex deployment URL, public/safe for client. Set by npx convex dev.
CONVEX_DEPLOY_KEY	CI/CD (Vercel build)	Server-only, used for npx convex deploy.
RESEND_API_KEY	Convex environment (npx convex env set)	Never exposed to the client — email actions run in Convex, not Next.js.
NEXT_PUBLIC_POSTHOG_KEY / NEXT_PUBLIC_POSTHOG_HOST	Next.js client	Analytics; must be configured to exclude PII (see PRD § 2 Security).
NEXT_PUBLIC_SENTRY_DSN	Next.js client/server/edge	Error tracking.
SENTRY_AUTH_TOKEN	Build time only	Source map upload; not needed at runtime.
ADMIN_EMAILS	Convex Auth config	Comma-separated allowlist of coach accounts — no public sign-up path. Read via convex/adminEmails.ts.
ADMIN_EMAIL	Convex environment	Recipient of the new-lead alert (convex/notify.ts), and a fallback allowlist entry.

Stack

Next.js (App Router) + Convex + Convex Auth + Resend + PostHog + Sentry, deployed on Vercel. See docs/VISION.md § Tech Stack for the rationale behind each choice.

Build Status

Following docs/product-roadmap.md. Currently in Phase 0 — Foundation & Setup.