Fahrklar

Live demo · Deutsch · Русский · Project management · Architecture · Security

Fahrklar is a mobile-first training product for the German practical driving test (Fahrprüfung Klasse B). It combines German examiner language with clear Russian explanations, visual decision exercises and vehicle-check preparation.

Product targets multilingual learners in Germany. Repository documentation is available in English, German and Russian for international review.

Live product

Production: fahrklar-klasse-b.vercel.app

No account required. Progress stays on current device.

Product scope

• first-run onboarding for exam date, preparation stage and weak topics;
• 20 visual road situations with safe/unsafe decisions;
• 40 compressed, mobile-friendly WebP assets;
• 36 vehicle-check and technical questions;
• German examiner commands with browser speech playback;
• five Grundfahraufgaben manoeuvre guides;
• timed 12-question mock exam;
• automatic error-review queue;
• local progress tracking;
• responsive desktop and mobile interface;
• readable type scale with stronger secondary-text contrast.

Engineering highlights

• typed learning content and reusable React training modules;
• Next.js App Router with server-rendered metadata;
• native Next.js production build for Vercel;
• retained Vinext build for Cloudflare-compatible deployment;
• no backend, accounts, cookies or analytics;
• Content Security Policy and defensive HTTP headers;
• CI covering lint, TypeScript, both production builds, tests and audit;
• asset-budget test keeps every scenario image below 100 KB;
• zero known npm vulnerabilities at last validation.

Local development

Requirements: Node.js >=22.13.0.

npm ci
npm run dev:vercel

Open http://localhost:3000.

Validation

npm run check

This runs linting, TypeScript checks, Vinext build and render tests, native Next.js build, plus production dependency audit.

Architecture

typed training data
        |
        v
React learning modules ---> browser localStorage
        |
        +-- situations
        +-- vehicle checks
        +-- examiner commands
        +-- mock exam
        +-- error review

Detailed decisions: docs/architecture.md.

Privacy and security

Fahrklar sends no learner profile or progress to a server. Optional display name, exam date, focus topics and results use localStorage only. Repository requires no runtime secrets. See SECURITY.md for reporting and controls.

Official references

• German Road Traffic Regulations — StVO
• FeV Annex 7 — driving licence examination
• Federal Ministry of Transport — driving licence examination

Disclaimer

Training scenarios and images are educational material. Fahrklar is not an official TÜV/DEKRA question catalogue, is not affiliated with TÜV, DEKRA or ADAC, and does not replace lessons with a qualified driving instructor.