Skip to content

pawan67/zentime

Repository files navigation

ZenTime - Simple Pomodoro Timer

A simple yet sophisticated Pomodoro timer with no ads and no distractions. Built for productivity and focus.

Why ZenTime?

  • 🚫 No ads or distractions
  • 🎯 Clean, minimalist interface
  • ⚡ Built for productivity
  • 🎨 Beautiful design
  • 🔒 Privacy-focused with local storage
  • 💾 Data portability with export/import

Features

  • ⏱️ Customizable Pomodoro timer
  • 📝 Task management with Pomodoro tracking
  • 🎵 Sound notifications
  • 🌓 Light/Dark mode
  • 📱 Responsive design
  • 💾 Persistent storage
  • 📤 Export/Import functionality
  • 🔄 System theme detection
  • 🎯 Task statistics and progress tracking

Tech Stack

  • Next.js 14
  • TypeScript
  • Tailwind CSS
  • Shadcn UI
  • Zustand
  • PWA Support

Getting Started

  1. Clone the repository:

    git clone https://github.com/yourusername/zentime.git
  2. Install dependencies:

    cd zentime
    npm install
  3. Run the development server:

    npm run dev
  4. Open http://localhost:3000 in your browser.

Usage

Timer

  • Click the timer to start/pause
  • Use the settings to customize work/break durations
  • Enable/disable sound notifications
  • Track completed Pomodoros

Tasks

  • Add tasks with estimated Pomodoro counts
  • Mark tasks as complete
  • Track Pomodoros per task
  • Clear completed or all tasks from settings

Settings

  • Toggle between light and dark mode
  • Enable/disable sound notifications
  • Customize timer durations
  • Export/Import your data:
    • Export: Download a JSON file containing all your tasks, completed Pomodoros, and settings
    • Import: Upload a previously exported JSON file to restore your data
    • Use this feature to backup your data or transfer it to another device

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

A beautiful and efficient Pomodoro timer application

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •