Skip to content

E3Prime/pomodoro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pomodoro Focus Timer

HTML5 Badge CSS3 Badge TypeScript Badge Tailwind CSS Badge Vite Badge Bun Badge

A highly customizable productivity timer built to enforce effective study habits. It features strict timeboxing rules, immersive atmospheric effects, and full aesthetic control via TypeScript and Tailwind CSS.

🔗 Links

⏳ Pomodoro Focus Atmosphere Showcase

Pomodoro App Demo

Features a calming particle atmosphere and a circular progress ring that visualizes time remaining.

🧐 About The Project

This application is a study companion designed to keep users in a state of flow. Built with TypeScript, it enforces specific "productivity rules" to ensure breaks don't turn into distractions.

Users can toggle between three modes, pause/reset the timer, and customize the look and feel of the application to match their personal aesthetic (Minimalist, Cyberpunk, or Classic).

Key Features

  • Strict Timeboxing Logic:
    • Pomodoro: Flexible focus time (1 - 99 minutes).
    • Short Break: Enforces a 15 - 30 minute window.
    • Long Break: Enforces a 30 - 60 minute window.
    • Validation: Prevents invalid inputs (blank, zero, out-of-bounds, or characters) with custom error messages.
  • Immersive Visuals:
    • Canvas Particles: A background system of rotating, floating particles creates a "Focus/Chill" atmosphere.
    • Circular Progress Bar: A dynamic SVG ring depletes in real-time, pulsing and fading out when the timer hits zero.
  • Audio Feedback: Plays a distinct sound effect upon completion to alert the user.
  • Full Customization (Settings Modal):
    • Fonts: Select between 3 distinct typefaces (Modern, Futuristic, Fancy).
    • Colors: Choose a primary accent color that updates the progress bar and active UI elements instantly.

About

Pomodoro Timer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors