Countdown App

A minimalist, motivational study timer designed to help you track focus sessions, hit goals, and stay on the grind. Built with React and deployed via GitHub Pages, this app blends simplicity with features that nudge you toward intentional productivity.

Live app: https://gilxsilva.github.io/countdown-app

Check out full documentation: [https://docs.google.com/document/d/1ifq0H-XDFEPytqsbeqeU0lvMULVlQpQO_nhHsFE4944/edit?usp=sharing)

---

Features

• Live countdown timer
• Real-time clock display
• Motivational messages
• Responsive and minimal UI
• Quick start mode
• Session planning support
• Custom (funny) study playlists (coming soon)
• Badges, nudges & milestone sharing (planned)

---

Tech Stack

• Frontend: React (Create React App)
• Languages: JavaScript, HTML, CSS
• Deployment: GitHub Pages
• Version Control: Git

---

Installation

git clone https://github.com/gilxsilva/countdown-app.git
cd countdown-app
npm install
npm start

Deployment

npm run build
npm run deploy

Make sure to configure the homepage field in package.json and install gh-pages.

---

Roadmap

• User accounts for saving session history (optional)
• Leaderboards & friend study mode
• Spotify playlist integration
• Speech reminders ("You have 15 minutes left!")
• Session name + shareable milestone posts