Kiryoku

気力 (Kiryoku) - Inner energy, drive, motivation, willpower

Kiryoku is a minimalist, macOS‑inspired focus companion that helps you get into deep work with intention, gentle ambient sound, and a calm interface.

Built with Electron, React, and TypeScript.

Features

• Minimalist timer experience

  • Clean, horizontal progress bar with focus duration in minutes
  • Grainy, e‑ink inspired dark theme designed for low visual noise
  • Idle, running, and finished states with tailored layouts

• Personalized experience

  • Onboarding flow to capture your name and greet you personally
  • Editable name in Settings
  • Branded home screen with current date, time, and subtle “Kiryoku” identity

• Smart session tracking

  • Sessions only saved when you explicitly record them
  • Feedback modal after each session: Happy, Neutral, Sad
  • totalFocusTime only counts Happy/Neutral sessions
  • Sad sessions are still recorded but visually muted in history
  • Daily auto‑clear of session history after midnight

• Sessions history

  • Timeline of past sessions with duration, date, and feedback icon
  • Expandable session cards for inline details (no side drawer)
  • Delete single session or clear all sessions
  • Effective focus stats (e.g. total focused minutes, effective sessions)

• Ambient sound control

  • Integrated dock sound control with multiple ambient tracks (e.g. ocean, rainforest)
  • Volume and mute with smooth slider and state persistence
  • Sound only plays while a focus session is running
  • Sound selection remembered between app launches

• Website blocking

  • Configure a list of distracting sites to block during sessions
  • Preset bundles for common distractions (Social, Entertainment, etc.)
  • Custom site input with pill/badge UI for quick add/remove

• Flexible settings

  • Duration presets (Pomodoro, Deep Work, Ultra, etc.)
  • Custom duration input (1–180 minutes)
  • Session goal field (what you're working on)
  • Notes field for context and reflections

• Modern UI & layout

  • Bottom dock navigation: Home, Start, Stop, Settings, Sessions, Sound
  • SVG icon set (no emojis) for a cohesive, premium feel
  • Neatly spaced cards, typography, and sticky‑style headers where appropriate

• Persistence & reliability

  • Settings, sessions, and sound preferences stored locally
  • Host file manipulation to block/unblock sites per session via the main process

Recommended IDE Setup

• VSCode + ESLint + Prettier

Project Setup

Install

$ npm install

Development

$ npm run dev

Build

# For windows
$ npm run build:win

# For macOS
$ npm run build:mac

# For Linux
$ npm run build:linux