Focusly

Focus deeper. Achieve more.

A minimalist Pomodoro timer designed for deep work. Beautiful, distraction-free, and built to help you enter flow state.

---

✨ Features

Pomodoro Timer

• Classic Mode — 25/5/15 (work/break/long break)
• Deep Focus — 50/10/20
• Ultra Focus — 90/20/30
• Custom Mode — Fully configurable durations
• Configurable cycles before long break
• Session presets
• Local session history

Notifications

• Native system notifications
• Configurable alarm sounds with ring on session/break completion
• Visual feedback animations

Personalization

• Dark / Light theme
• Violet & Cyan color palette
• Persistent preferences

Animations (GSAP)

• Smooth state transitions
• Animated progress ring
• Breathing effect during focus
• Microinteractions on hover/click

---

🚀 Project Structure

focusly/
├── app/                    # Electron desktop application
│   ├── src/
│   │   ├── main/          # Electron main process
│   │   ├── renderer/      # Frontend UI
│   │   └── assets/        # App assets (logo, sounds)
│   └── package.json
├── landing/               # Astro landing page
│   ├── src/
│   │   ├── components/    # Astro components
│   │   ├── layouts/       # Page layouts
│   │   ├── pages/         # Routes
│   │   └── styles/        # Global styles
│   └── package.json
└── README.md

---

🛠️ Installation

Desktop App

cd app
bun install
bun start

Landing Page

cd landing
bun install
bun dev

---

📦 Build

Desktop App

cd app
bun run build

Landing Page

cd landing
bun build

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Space	Start/Pause timer
Ctrl+R	Reset timer
Escape	Close panels

---

🎨 Tech Stack

Component	Technology
Desktop App	Electron
Animations	GSAP
Frontend	Vanilla JS
Theming	CSS Variables
Landing Page	Astro
Styling	TailwindCSS

---

📄 License

MIT License — feel free to use this project for personal or commercial purposes.

---