Skip to content

JanoTheDev/Lebanese-Driving-Test

Repository files navigation

Lebanese Driving Test Practice 🚗

A free web application to help people practice for the Lebanese driving license computer test. This project aims to provide an accessible and user-friendly way to prepare for the official test.

Features ✨

  • Two Quiz Modes:
    • Normal Mode (Similar to official test: 10 law, 10 safety, and 10 sign questions)
    • Endless Mode (Practice all questions with instant feedback)
  • Available in three languages:
    • English 🇬🇧
    • French 🇫🇷
    • Arabic 🇦🇪
  • Dark/Light mode support
  • Mobile-friendly design
  • Timer for normal mode
  • Detailed review system
  • Progress tracking

Try it Online 🌐

Visit Lebanese Driving Test Practice to start practicing!

Run Locally 💻

Prerequisites

  • Node.js (version 18 or higher)
  • npm (comes with Node.js)

Installation Steps

  1. Clone the repository
git clone https://github.com/yourusername/lebanese-driving-test.git
cd lebanese-driving-test
  1. Install dependencies
npm install
  1. Start the development server
npm run dev

Contributing 🤝

We welcome contributions! Please follow these steps:

  1. Fork the repository

  2. Create a new branch

  3. Make your changes and commit them

  4. Push to your fork

  5. Create a pull request

  6. Open http://localhost:3000 in your browser

Contributing 🤝

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Areas where we need help:

  • Adding more questions to the database
  • Improving translations
  • Enhancing UI/UX
  • Bug fixes
  • Documentation improvements

Issues 🐛

Found a bug or have a suggestion? Please report it in the Issues section of our GitHub repository. When reporting bugs, please include:

  • A clear description of the issue
  • Steps to reproduce
  • Expected behavior
  • Screenshots (if applicable)
  • Your browser and device information

About the Test 📝

The Lebanese driving license computer test consists of:

  • 30 questions (10 law, 10 safety, 10 signs)
  • 15-minute time limit
  • Passing score: 26/30 (87%)
  • Available in English, French, and Arabic

License 📄

This project is licensed under the MIT License - see below for details:

MIT License

Copyright (c) 2024 JanoTheDev

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Support 💬

If you need help:

  • Check the Issues section
  • Create a new issue for questions
  • Contact through GitHub

Made with ❤️ by JanoTheDev

About

Free lebanese driving test with the same questions that will be asked during the test

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors