VoiceHire

AI-powered recruiting automation — job postings, candidate pipeline, screening, analysis, and interview scheduling.

• Job Postings: browse roles and drill into a specific job.
• Candidates: review applicants, run first screening, view analysis, schedule interviews.
• Modern UI: clean dark theme, smoother interactions, and lighter animation work.
• Safe demo mode: key pages gracefully fall back to sample data when APIs/DB aren’t available.

• Next.js (App Router): next@15
• React: react@19
• TypeScript
• Tailwind CSS
• UI helpers: shadcn/ui, Radix, Headless UI

From the repo root:

cd frontend
npm install
npm run dev

Then open http://localhost:3000.

This repo’s deployable frontend lives in frontend/.

This works because the UI uses sample-data fallbacks if job/candidate APIs fail.

1. Create a new Vercel project from this repo
2. Set Root Directory to frontend
3. Framework preset: Next.js
4. Deploy

Notes:

• The repo contains Next.js API routes under frontend/src/app/api/*. If you do not configure a database, those routes may return 500, and the UI will automatically fall back to sample data.

If you want real jobs/candidates data from the API routes, configure the environment variables used by your database client in Vercel (for example, DATABASE_URL / Vercel Postgres connection vars — depending on how your pool is configured in frontend/src/actions/db).

After setting env vars:

• Redeploy on Vercel
• Verify /api/jobs and /api/candidates return JSON successfully

frontend/
  src/
    app/                 # App Router routes (pages + API routes)
    components/          # UI components (tables, modals, sidebar, etc.)
    lib/                 # utilities + mock/sample data

From frontend/:

npm run dev     # local dev server
npm run build   # production build
npm run start   # run the production build locally
npm run lint    # lint

Private / internal project (update as needed).