Skip to content

Jambite, a web application where prospective Nigerian Students and undergraduates can practice Nigeria's most prestigious tertiary institution entry Computer Based Test.

License

Notifications You must be signed in to change notification settings

MChiemelie/jambite

Repository files navigation

Jambite 🆒📚

header header
🚀 Jambite hero section
Theme is set according to your device's theme.

📖 Jambite is a web application designed to aid prospective Nigerian students and undergraduates in preparing for the Joint Admissions and Matriculation Board (JAMB) Computer-Based Test (CBT).

With over 20,000 JAMB past questions, Jambite offers a comprehensive suite to help students practice for JAMB CBT exams, eliminating the need for physical past question papers and enabling practice in the CBT format.

🌟 Features

  • Access to free online mock exams 📝
  • Extensive collection of practice questions and answers for all JAMB subjects 📚
  • User-friendly interface for effortless navigation 🖥️

🚀 Getting Started

Embark on your Jambite journey by visiting the Jambite website and creating an account. From there, you can take tests and practice for the JAMB CBT. 🎉

👩‍💻👨‍💻 For Developers

🤝 Contributing

Jambite is an open-source project, and contributions from individuals interested in enhancing the project are welcomed. If you have suggestions or ideas for new features, please submit a pull request or open an issue on the GitHub repository. Your contributions play a pivotal role in making Jambite better. 🌟

🛠️ Technologies Used

  • Next.js (App Router)
  • TailwindCSS (Styling)
  • Supabase (PostgreSQL) (Authentication and Database)

📋 Prerequisites for Use and Contribution

  • Basic understanding of TailwindCSS
  • Proficiency in Next.js
  • Familiarity with PostgreSQL and Supabase

🛠️ Setup

Before proceeding with the installation, ensure you have the following tools installed:

  • Git (for contribution)
  • Node.js (for contribution)

⏬ Installation Steps

  1. Fork the project by clicking the "Fork" icon in the upper right corner.

  2. Clone the project using the following command:

    git clone https://github.com/<your-github-username>/Jambite
  3. Navigate to the project directory:

    cd Jambite
  4. Install project dependencies with npm:

    npm install
  5. Launch the development environment:

    npm run dev
  6. After developing and making your contribution, check for warnings and errors:

    npm run lint
  7. When you're done with linting, run the build command to transpile, bundle, and get the optimized production-ready version of the code:

    npm run build
  8. To test your optimized production-ready version of the code, run:

    npm run start

✍️ Making Your Contributions

  1. Create a new branch:

    git checkout -b YourBranchName
  2. Stage your changes (do not commit the package.json):

    git add <path to the file you worked on>
  3. Commit your changes:

    git commit
  4. Push your changes:

    git push

📄 License

Jambite is released under the MIT License. For more details, refer to the LICENSE file.

🙏 Thank You and Anticipated Contributions

Thank you for dedicating your time to reading and contributing to Jambite. Your contributions are immensely valued and play a significant role in driving the open-source community forward. Keep up the fantastic work! 🍻

❤️ Support

This project thrives on stars⭐. If you find value in what we're doing, please consider leaving a star✨.

Meet the Developer

Hey 👋, I am Melikam Chiemelie, a frontend developer.
Follow me on 🐦 Twitter!
Want to connect? Send me an email at 📧 [email protected].

About

Jambite, a web application where prospective Nigerian Students and undergraduates can practice Nigeria's most prestigious tertiary institution entry Computer Based Test.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published