PDD 2026

PDD 2026 is a modern, high-performance offline desktop application designed to help users study and prepare for the Russian Traffic Rules (ПДД) theoretical exam.

Built with React, TypeScript, Tailwind CSS, and packaged inside a secure, sandboxed Electron container, PDD 2026 delivers a visually stunning and perfectly smooth learning experience.

✨ Features

• Official Database: Includes all official 40 tickets (800 questions) and topics for the Russian Traffic Rules exam.
• Smart Translation Mode: Allows users to seamlessly switch between Russian and English, or use a "Hover" mode to instantly reveal English translations while studying in Russian.
• Mock Exam Simulation: Experience a realistic exam environment with a built-in timer, strict error counting, and performance tracking.
• Offline & Secure: Runs 100% offline via Electron, utilizing a bundled local JSON database for zero-latency loading and complete privacy.
• Detailed Statistics: Tracks your historical performance so you can monitor your progress over time.
• Modern UI: Features a beautiful dark/light mode, custom SVGs, fluid micro-animations, and a highly responsive grid layout powered by Tailwind CSS.

🛠️ Technology Stack

• Frontend: React 18, Vite, TypeScript
• Styling: Tailwind CSS
• State Management: Zustand (with persistent local storage via Electron IPC)
• Desktop Packaging: Electron & Electron-Builder
• Icons: Lucide React

🚀 Getting Started

Prerequisites

Make sure you have Node.js installed on your machine.

Installation

1. Clone the repository:

   git clone https://github.com/chibsaabji/PDD-2026.git
   cd PDD-2026

2. Install dependencies:

   npm install

Development

To start the Vite development server and launch the Electron wrapper locally:

npm run dev

Production Build

To compile the TypeScript, bundle the frontend via Vite, and package the final executable using Electron-Builder:

npm run build

The final standalone Windows installer (.exe) will be generated inside the /release/1.0.0/ directory.

🛡️ Security

This application is strictly sandboxed. Node integration is disabled in the frontend Renderer process, and all local storage calls are securely bridged via an isolated IPC context (preload.ts).

---

Built with ❤️ by Chibsaabji