https://github.com/riansap/moodoro
😑 A Desktop app for Pomodoro Timer built with Electron.js
https://github.com/riansap/moodoro
electron-app javascript react typescript webpack
Last synced: 3 months ago
JSON representation
😑 A Desktop app for Pomodoro Timer built with Electron.js
- Host: GitHub
- URL: https://github.com/riansap/moodoro
- Owner: riansap
- Created: 2025-05-07T18:34:41.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-07T19:16:37.000Z (about 1 year ago)
- Last Synced: 2025-05-09T01:45:44.241Z (about 1 year ago)
- Topics: electron-app, javascript, react, typescript, webpack
- Language: TypeScript
- Homepage:
- Size: 844 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# 😑 Moodoro
### A Modern Pomodoro Timer for Your Desktop
Moodoro is a minimalist desktop Pomodoro Timer built to help you stay focused, block distractions, and boost productivity using the proven Pomodoro Technique.
Built with Electron.js and powered by the [Electron React Boilerplate](https://github.com/electron-react-boilerplate/electron-react-boilerplate), it provides a clean, distraction-free interface right on your desktop — no internet required!
## ✨ Features
- 🎯 **Focus-First Design**: Clean, distraction-free interface
- ⚡ **Instant Access**: Native desktop app, no browser needed
- 🔔 **Smart Notifications**: Native system notifications for session transitions
- 🎨 **Theme Support**: Multiple themes to match your mood
- 💻 **Cross-Platform**: Works on macOS, Windows, and Linux
- 🔒 **Privacy-Focused**: Fully offline, no data collection
## 🚀 Getting Started
### Installation (Work In Progress)
1. Download the latest release for your platform from our [Releases](https://github.com/riansap/moodoro/releases) page
2. Run the installer
3. Launch Moodoro and start focusing!
### Development
Prerequisites:
- Node.js (LTS version recommended)
- npm or yarn
```bash
# Clone the repository
git clone https://github.com/riansap/moodoro.git
cd moodoro
# Install dependencies
npm install
# Start development server
npm start
# Build for production
npm run build
# Package the app
npm run package
```
## 🛠 Tech Stack
- Framework : Electron
- Frontend : React + TypeScript
- Boilerplate : Electron React Boilerplate
- Build Tool : Electron Builder
## 🗺 Roadmap
- Customizable sounds/notifications
- Multi-language support
- Session statistics and insights
- Task integration (Notion, Todoist, etc.)
## 👨💻 Author
Rian Saputra - @riansap