Architecture

The current repo is a hiring-platform monorepo with a live Veref marketing layer and a recruiter-workflow foundation underneath it.

Runtime surfaces

• apps/web for public marketing
• apps/app for recruiter operations
• apps/api for product APIs and webhooks
• apps/cli for agent and tech-team command line workflows
• apps/desktop for local AI-assisted recruiter workflows
• apps/mobile for recruiter notifications and lightweight triage
• apps/extension for recruiter workflows inside browser hiring surfaces
• apps/docs for internal and external docs

Shared packages

• @veref/contracts for shared types and zod schemas
• @veref/db for Prisma schema and Postgres access
• @veref/workflows for recruiter workflow and reference lifecycle helpers
• @veref/comms for email and SMS adapters
• @veref/llm for OpenRouter integration
• @veref/desktop-bridge for Electron IPC contracts

Product reality

• The implemented backend foundation is reference- and recruiter-ops-centric.
• The public apps/web experience already describes the broader Veref Interview + Passport + References platform.
• The repo is therefore best understood as a Veref platform monorepo whose application foundation is still catching up to the full product roadmap.