Chronos Pomodoro

A modern Pomodoro timer built with React + TypeScript + Vite. Focus cycles, short/long breaks, task history, theming and mobile responsive design.

Demo

Live Demo

Layout

Features

• Pomodoro cycles: work, short break, long break
• Countdown with formatted time
• Start/stop tasks with audio feedback
• Task history with completion/interrupt tracking
• Dark/light theme (CSS variables)
• Type-safe state management with reducer

Tech Stack

• React + TypeScript + Vite + Vercel
• CSS Modules
• Lucide React (icons)
• ESLint/Prettier

Scripts (typical Vite)

• npm run dev — start dev server
• npm run build — production build
• npm run preview — preview build
• npm run lint — lint (if configured)

Contributing

Feel free to open issues or submit pull requests for improvements!

How to Run

Prerequisites:

• Node.js 20+

Install and run:

git clone https://github.com/IgorJFS/Chronos-Pomodoro-React
cd Chronos-Pomodoro-React
npm install
npm run dev

Build and preview:

npm run build
npm run preview

License

MIT License