vibe-coding-practice-pomodoro

A pomodoro timer app for different types of focused sessions (e.g. coding, reading, planning, reflecting).

Features

1. Timer Interface

• Visual countdown timer display
• Clear, easy-to-read time remaining
• Start, pause, and reset controls

2. Session Type Selection

• Choose session type before starting the timer:
  • Coding - Deep work programming sessions
  • Reading - Focused reading and learning
  • Planning - Strategic thinking and planning
  • Reflecting - Review and retrospection

3. Task Tracking & Reminders

• Enter the name of the task to be done for each session
• Session completion notifications
• Reminder to rest and drink water when the session ends

Quick Start

1. Read CLAUDE.md first - Contains essential rules for Claude Code
2. Follow the pre-task compliance checklist before starting any work
3. Use proper module structure under src/main/python/
4. Commit after every completed task

Project Structure

vibe-coding-practice-pomodoro/
├── CLAUDE.md              # Essential rules for Claude Code
├── README.md              # Project documentation
├── .gitignore             # Git ignore patterns
├── src/
│   ├── main/
│   │   ├── python/        # Python source code
│   │   │   ├── core/      # Core business logic (timer, sessions)
│   │   │   ├── utils/     # Utility functions
│   │   │   ├── models/    # Data models
│   │   │   ├── services/  # Service layer
│   │   │   └── api/       # API interfaces
│   │   └── resources/
│   │       ├── config/    # Configuration files
│   │       └── assets/    # Static assets
│   └── test/
│       ├── unit/          # Unit tests
│       └── integration/   # Integration tests
├── docs/                  # Documentation
├── tools/                 # Development tools
├── examples/              # Usage examples
└── output/                # Generated output files

Development Guidelines

• Always search first before creating new files
• Extend existing functionality rather than duplicating
• Use Task agents for operations >30 seconds
• Single source of truth for all functionality

Usage

GUI Application (Recommended)

# Run the GUI app
python3 run_gui.py

CLI Application (Terminal)

# Run the CLI version
python3 src/main/python/core/main.py

Custom Background Image

Place your background image at:

src/main/resources/assets/background.png

The GUI will automatically load it. Requires Pillow: pip3 install Pillow