Testowo is a web application built using the MERN (MongoDB, Express.js, React.js, Node.js) stack that allows users to create and enroll in multiple choice tests. It is a user-friendly platform designed to facilitate the creation and participation in various tests, making it ideal for educational purposes, training, or simply for fun.
-
User Registration and Authentication: Users can create accounts and log in securely to access the application's features.
-
Test Creation: Registered users can create multiple choice tests by providing questions, answer options, and marking the correct answer.
-
Test Enrollment: Users can browse and enroll in tests created by others, allowing them to test their knowledge in various subjects.
-
Real-time Feedback: After completing a test, users receive instant feedback, including their score and correct answers.
-
User Profiles: Users can view their test history, including tests they've created and tests they've taken.
-
Search and Filter: A search and filter system enables users to find specific tests easily.
-
Responsive Design: Testowo is designed to work seamlessly on both desktop and mobile devices.
- Clone the repository:
git clone https://github.com/Daniel-Badura/Testowo.git
- Install server dependencies:
npm install
- Install client dependencies:
cd frontend
npm install
- Create a .env file in the server directory with the following content and replace the values with your own:
MONGODB_URI=your_mongodb_uri SECRET_KEY=your_secret_key
- Start server and client in dev mode:
npm run dev
- Open your web browser and access the application at http://localhost:3000.
-
Register for an account or log in if you already have one.
-
Once logged in, you can create a new test by clicking the "Create Test" button.
-
Fill in the details of your test, including questions, answer options, and the correct answer.
-
After creating a test, you can browse and enroll in tests created by other users from the homepage.
-
To take a test, click on the test card, and it will guide you through the questions.
-
After completing a test, you will receive instant feedback on your performance.
-
You can view your test history and scores on your profile page.
We welcome contributions to Testowo! If you'd like to add new features, fix bugs, or improve the application in any way, please follow these steps:
-
Fork the repository.
-
Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-name
- Make your changes and commit them:
git commit -m "Add your feature or fix description"
- Push your changes to your fork:
git push origin feature/your-feature-name
-
Create a pull request on the original repository, explaining your changes and their benefits.
-
Your pull request will be reviewed, and once approved, it will be merged into the main branch.
This project is licensed under the MIT License - see the LICENSE file for details.
Thank you for using Testowo! We hope you find it useful and enjoy using it as much as we enjoyed building it. Happy testing!