Skip to main content

Getting Started with Evolve Admin Frontend

Prerequisites​

  • Node.js 20+
  • npm / yarn / pnpm / bun
  • Access to TeamFleetStudio/evolve-admin-fe
  • Evolve backend API URL (see .env.example)

Installation​

Step 1: Clone​

git clone https://github.com/TeamFleetStudio/evolve-admin-fe.git
cd evolve-admin-fe

Step 2: Install dependencies​

npm install

Step 3: Configure environment​

NEXT_PUBLIC_API_BASE_URL=http://localhost:3003

Step 4: Run​

npm run dev

Open http://localhost:3000 and log in with an admin/staff account.

Useful scripts​

ScriptPurpose
npm run devLocal Next.js dev server
npm run build / npm startProduction build/serve
npm run lintESLint

Verification​

  • Login works against the configured Evolve backend
  • Resource Management lists question banks, and the view modal shows prompt questions with acceptance criteria
  • Sidebar/table totals include prompt questions in their counts
  • Test Management shows results per round and allows moving a candidate to the next round
Shared backend

This app and evolve-candidate-fe point at the same Evolve backend API - use a backend instance that has test/candidate data seeded to see anything useful.

Troubleshooting​

Issue: Question bank total count looks wrong

  • Solution: Confirm promptQuestions is included in both the sidebar total and the QB table's data-transform (this was a known gap, fixed in apiConfig/QB view logic)

Issue: Table sorting doesn't match expected order

  • Solution: Check the AG Grid column def's comparator/sortable config for that column

Next Steps​