Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mahmud0808/examtimer
Track and manage your exam time effectively.
https://github.com/mahmud0808/examtimer
exam-timer nextjs15 shadcn-ui tailwindcss timer typescript
Last synced: about 1 month ago
JSON representation
Track and manage your exam time effectively.
- Host: GitHub
- URL: https://github.com/mahmud0808/examtimer
- Owner: Mahmud0808
- License: mit
- Created: 2024-11-23T19:19:26.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-11-24T13:57:31.000Z (about 1 month ago)
- Last Synced: 2024-11-24T14:22:19.596Z (about 1 month ago)
- Topics: exam-timer, nextjs15, shadcn-ui, tailwindcss, timer, typescript
- Language: TypeScript
- Homepage: https://quiktimer.vercel.app
- Size: 211 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Exam Timer ⏲️
Welcome to **Exam Timer**, a web-based timer application designed to keep track of exam durations accurately, even in the event of unexpected interruptions.
## Why Exam Timer? 🤔
### There are countless timer projects available online, so why create a new one? Here's the story behind Exam Timer:
During one of my exams, the teacher used a random online timer projected on a screen. Unfortunately, halfway through the exam, a power outage reset the timer. When the power was restored, the teacher restarted the timer but reduced the remaining time inaccurately. I was certain the time wasn't correct, but I couldn't argue without wasting more time. This experience inspired me to develop a timer that saves its state in local storage, ensuring accurate time tracking even after interruptions.
## Features ✨
- **Persistent Timer**: Saves the timer state in local storage, so it continues accurately even if the session is restarted.
- **User-friendly Interface**: Clean and intuitive UI for easy use during exams.
- **Customizable Settings**: Adjust the timer duration to fit any exam length.
## Tech Stack 🛠️
- **Next.js 15**: The latest version of Next.js for a robust and scalable React application framework.
- **shadcn UI**: A sleek and modern UI component library.
- **Tailwind CSS**: Utility-first CSS framework for rapid UI development.
- **TypeScript**: Typed JavaScript for better code quality and developer experience.
## Getting Started 🚀
Follow these steps to get the project up and running locally:
1. **Clone the repository**:
```bash
git clone https://github.com/Mahmud0808/ExamTimer.git
cd ExamTimer
```
2. **Install dependencies**:
```bash
npm install
```
3. **Run the development server**:
```bash
npm run dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Contributing 🤝
Contributions are welcome! If you have suggestions or bug reports, please open an issue or submit a pull request.
## License 📄
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
---
Thank you for checking out **Exam Timer**! I hope it helps you in managing exam durations more accurately and efficiently. If you have any questions or feedback, feel free to reach out.
Happy timing! ⏳