Skip to content

AlexTheGreat600/vpomodoro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

69 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ… Vpomodoro

Screenshot Charts Screenshot Activity Screenshot Settings Screenshot Webapp

A modern, feature-rich Pomodoro timer with stunning themes, custom activities, and powerful customization options.

✨ Features

  • ⚑ Lightweight – Single HTML file with zero build dependencies
  • πŸ“Š Statistics Charts - View statistics by clicking stats button
  • πŸ“± Responsive Design – Works beautifully on desktop and mobile devices
  • πŸš΄β€β™€οΈ Random Activities - Select random activities by clocking random button
  • πŸ’Ύ Local Storage – All your settings and activities persist between sessions
  • ⏱️ Flexible Timer Control – Easily adjust work, break, and long break intervals
  • 🎨 Random Themes - Random theme is selected by default, change that in settings
  • 🎨 Multiple Themes – Beautiful themes including Dracula, Nord, Gruvbox, Solarized, and more
  • πŸ“ Custom Activities – Create and manage unlimited custom activities with unique timers and colors
  • 🎭 Customizable UI – Change fonts, progress bar shapes (circle, semi-circle, line), and stroke thickness

🎯 Default Activities

The app comes pre-loaded with six activities:

  • 🎨 Design – 40 min work, 8 min break
  • ✍️ Writing – 30 min work, 5 min break
  • πŸ’» Coding – 50 min work, 10 min break
  • πŸ“š Reading – 25 min work, 5 min break
  • πŸ‹οΈ Fitness – 45 min work, 5 min break
  • 🧠 Deep Work – 90 min work, 15 min break
  • More...

🎨 Available Themes

  • Dracula – Dark and vibrant
  • Monokai - Classic editor theme
  • Default – Random theme selected on load
  • Nord – Arctic, north-bluish color palette
  • Greenscreen – Classic retro terminal style
  • Ayu Light & Ayu Dark – Clean and minimal
  • Gruvbox Light & Gruvbox Dark – Retro groove colors
  • Solarized Light & Solarized Dark – Precision colors for machines and people

πŸš€ Quick Start

Simply clone repo and open index.html in your browser. No installation or dependencies required!

Usage:

  1. Select an activity or click random activity button
  2. Click the timer or press "Start" button to begin
  3. Use the +/- buttons to adjust time before starting
  4. Customize themes (random [default]), fonts, progress bar, progress bar thickness in Settings βš™οΈ
  5. Manage activities with the Activities dialog (appears after clicking activities button) πŸ“‹
  6. View usage data by clicking statistics button.
  7. Click screen button to fullscreen the webapp.

πŸ™ Credits & Libraries

This app is built with the following open-source libraries:

  • Chart.js - Simple yet flexible JavaScript charting library for the modern web
  • ProgressBar.js – Animated SVG progress bars with multiple shapes (Circle, SemiCircle, Line)
  • Bootstrap Icons – Comprehensive icon library for UI controls and actions

πŸ’ Handcrafted By

Built with ❀️ by Shivansh (my original name) & Gemini