https://github.com/jperez00/bonfire
A Productivity Timer Inspired by Video Games
https://github.com/jperez00/bonfire
darksouls nextjs tailwindcss timer tsparticles typescript videogames
Last synced: about 1 month ago
JSON representation
A Productivity Timer Inspired by Video Games
- Host: GitHub
- URL: https://github.com/jperez00/bonfire
- Owner: JPerez00
- License: mit
- Created: 2024-12-20T04:03:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-25T01:24:06.000Z (about 1 year ago)
- Last Synced: 2025-06-28T11:03:34.616Z (12 months ago)
- Topics: darksouls, nextjs, tailwindcss, timer, tsparticles, typescript, videogames
- Language: TypeScript
- Homepage: https://bonfire-ten.vercel.app
- Size: 8.47 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bonfire - A Productivity Timer Inspired by Video Games

Bonfire is your focus checkpoint. Rest, refocus, and level up your productivity with a timer application inspired by iconic video games.
## Live Project
[https://bonfire-ten.vercel.app/](https://bonfire-ten.vercel.app/)
## Features
- **Start/Pause Timer**: Easily control your countdown with intuitive start and pause functionality.
- **Restart Timer**: Reset your timer to the initial duration with a single click.
- **Settings Modal**: Customize your experience by selecting themes and setting timer durations.
- **Real-Time Date & Time Display**: Always stay updated with the current date and 12-hour formatted time.
- **Theme Customization**: Choose from multiple themes inspired by popular video games, currently featuring:
- **Dark Souls**: Immerse yourself in the dark and challenging ambiance of Dark Souls.
- **Shadow of the Colossus**: Experience the majestic and epic vibes of Shadow of the Colossus.
- **More Themes Coming Soon**: Stay tuned for additional themes to match your style.
- **Sound Effects**: Enjoy immersive sound effects for menu interactions and alerts to enhance user experience.
- **Responsive Design**: Optimized for both desktop and mobile views to ensure a seamless experience across devices.
- **GitHub Integration**: Easily navigate to the project's GitHub repository with a dedicated button.
## How It Works
Bonfire leverages modern web technologies to provide a robust and engaging user experience:
- **Next.js Framework**: Utilizes Next.js for a powerful and scalable frontend.
- **Real-Time Updates**: Displays the current date and time, updating every second without impacting performance.
- **Dynamic Theming**: Allows users to switch between themes, each offering unique visuals and soundscapes to match their preferences.
- **Sound Integration**: Implements Howler.js to manage and play sound effects seamlessly during user interactions.
- **Particle Effects**: Enhances visual appeal with dynamic particle animations based on the selected theme.
## The Goal
The goal of Bonfire is to provide a reliable and aesthetically pleasing timer application that caters to users seeking both functionality and customization. By integrating features like theme support, sound effects, and responsive design, Bonfire aims to enhance productivity and user experience. This is a work-in-progress project, with more themes and features to be added over time.
## Themes
This is a work in progress, it currently has 2 themes:
- **Dark Souls**
- **Shadow Of The Colossus**
More themes will be added over time.
## Getting Started
First, clone the repository and install the dependencies:
```bash
git clone https://github.com/JPerez00/bonfire
cd Bonfire
npm install
npm run dev
```