Skip to content

A clean, minimal Pomodoro timer featuring customizable focus cycles, ambient soundscapes, and dynamic backgrounds.

Notifications You must be signed in to change notification settings

gg2io/pomodoro_timer

Repository files navigation

React TypeScript Vite TailwindCSS Web Audio API Lucide

Pomodoro Timer

A clean, minimal Pomodoro timer featuring customizable focus cycles, ambient soundscapes, and dynamic backgrounds.


Features

  • Pomodoro, Short Break, and Long Break modes
  • Ambient sound options with matching backgrounds
  • Customizable durations
  • Optional auto-sequencing
  • Local settings persistence
  • Keyboard controls (Space to start/pause, R to reset)
  • Responsive design

Tech Stack

  • React 18 + TypeScript
  • Vite
  • Tailwind CSS
  • Web Audio API
  • Google Actions Sound Library
  • Lucide React

Getting Started

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:5173


Usage

  1. Select a timer mode
  2. Optionally choose an ambient sound
  3. Start the timer
  4. Adjust settings as needed

Credits

  • Sounds: Google Actions Sound Library
  • Backgrounds: Unsplash

Preview

Image

A snapshot of the app in action (example).


About

A clean, minimal Pomodoro timer featuring customizable focus cycles, ambient soundscapes, and dynamic backgrounds.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published