justsima/roadready

Ethiopia's national driver-theory app — Ministry pitch demo. Built by Globedock Academy. # RoadReady — Demo Ethiopia's national driver-theory learning and testing app, built by Globedock Academy in collaboration with the Federal Democratic Republic of Ethiopia's Ministry of Transport and Logistics. This is the **Ministry pitch demo**. It is a complete, clickable, bilingual (English + Amharic) preview of the user-side application. There is no backend — all data is mock seed data and all "Fayda" verification flows are visual simulations. ## Stack - Next.js 16 (App Router) · React 19 · TypeScript - Tailwind CSS v4 (using `@theme` tokens — no `tailwind.config.js`) - Framer Motion 12 (motion) - next-intl (i18n: `/en/...` and `/am/...`) - Recharts (analytics) - Lucide React (icons) - qrcode.react (desktop QR share) ## Running locally ```bash pnpm install pnpm dev # localhost (or PORT=3300 to override) pnpm build && pnpm start ``` Open `localhost` for English or `localhost` for Amharic. ## The 28 screens | # | Path | Screen | |---|---|---| | 1.1 | `/[locale]/onboarding/splash` | Splash | | 1.2 | `/[locale]/onboarding/language` | Language picker | | 1.3 | `/[locale]/onboarding/phone` | Phone + OTP | | 1.4 | `/[locale]/onboarding/fayda` | Fayda verification | | 1.5 | `/[locale]/onboarding/category` | Licence category | | 1.6 | `/[locale]/onboarding/goal` | Goal & exam date | | 2.x | `/[locale]/home?state={new\|progress\|ready}` | Home dashboard (3 states) | | 3.1 | `/[locale]/learn` | Learning hub | | 3.2 | `/[locale]/learn/[module]` | Module detail | | 3.3 | `/[locale]/learn/[module]/[lesson]` | Microlesson | | 3.4 | `/[locale]/learn/drill` | Road sign drill | | 3.5 | `/[locale]/learn/practice` | Practice quiz | | 3.6 | `/[locale]/learn/offline` | Offline manager | | 4.1 | `/[locale]/test` | Testing hub | | 4.2 | `/[locale]/test/briefing` | Mock briefing | | 4.3 | `/[locale]/test/exam` | In-exam view | | 4.4 | `/[locale]/test/results?score=N` | Mock results | | 4.5 | `/[locale]/test/analytics` | Perfor …