Built with Dark Factory v4 — autonomous AI software development pipeline
A modern Pomodoro Timer web application built with Next.js 15, TypeScript, and Tailwind CSS. Helps you manage work sessions using the Pomodoro Technique — 25-minute focused work intervals followed by 5-minute breaks.
- 🍅 Three timer modes: Focus (25 min), Short Break (5 min), Long Break (15 min)
- ⏯️ Start, Pause, Reset controls
- 📊 Visual progress indicator showing completed pomodoros
- 🔄 Auto-transition between modes
- 🔊 Sound notification when timer completes
- 📈 Session counter for daily focus sessions
- 🌙 Dark theme
- ⌨️ Keyboard shortcuts
- 📱 Fully responsive design
- Next.js 15, TypeScript, Tailwind CSS
- shadcn/ui component library
- Lucide icons
- Space - Start/Pause timer
- R - Reset timer
- 1 - Switch to Focus mode
- 2 - Switch to Short Break mode
- 3 - Switch to Long Break mode
- Node.js 18+ and npm
- Clone the repository:
git clone <repository-url>
cd pomodoro-timer- Install dependencies:
npm install- Run the development server:
npm run dev- Open http://localhost:3000 in your browser.
npm run build
npm startsrc/
├── app/
│ ├── layout.tsx # Root layout with dark theme
│ ├── page.tsx # Main page
│ ├── globals.css # Tailwind base styles
│ └── api/
│ └── health/
│ └── route.ts # Health check endpoint
├── components/
│ ├── PomodoroTimer.tsx # Main timer component
│ ├── TimerDisplay.tsx # Circular countdown display
│ ├── TimerControls.tsx # Control buttons
│ └── ProgressDots.tsx # Progress indicator
├── hooks/
│ └── useTimer.ts # Timer logic hook
└── lib/
└── audio.ts # Sound generation
GET /api/health- Health check endpoint
- Next.js 15 - React framework with App Router
- TypeScript - Type safety
- Tailwind CSS - Styling
- Web Audio API - Sound notifications
MIT