Automated Driving License Testing System – Frontend application for the Ethiopian digital driver licensing platform.
Built with Next.js 16, Tailwind CSS, TypeScript, and i18n support for Amharic/English.
ADLTS Frontend provides a modern, bilingual interface for Ethiopia's automated driving license testing system. It supports:
- Candidates – register, take exams, view results and history.
- Admins – manage devices, monitor active exams, oversee candidates.
- Super Admins – full system control (invitations, user management).
- Experts / Institutes / Transport Authorities – invitation‑based onboarding (coming soon).
The app is fully responsive, works with a real backend API, and includes a mock backend for local development.
- Authentication (login, registration, OTP verification, password reset)
- Role‑based redirection (candidate → candidate dashboard, admin → admin devices)
- Candidate Portal
- Dashboard with profile, stats, upcoming test
- Exam history table
- Result detail page (score breakdown)
- Admin Portal
- Device management dashboard (grid of devices with status, battery, storage)
- Active exams monitor (real‑time card grid)
- Candidate management table (search, status toggle)
- Bilingual UI (Amharic / English) with persistent language toggle
- Mock backend (local API routes for development)
- Protected routes (unauthorised users redirected to login)
- Responsive design (mobile, tablet, desktop)
| Area | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| State Management | Zustand + localStorage persistence |
| HTTP Client | Axios |
| Icons | Lucide React |
| i18n | Custom hook with local dictionaries (en, am) |
| Dev Mock API | Local Next.js API routes (app/api/v1/) |
| Testing (future) | Playwright |
| Deployment | Vercel |
- Node.js 20+ and npm
- Git
git clone https://github.com/ADLTS-Lab/ADLTS-Frontend.git
cd ADLTS-Frontend
npm install