docs: improve readme

2026-02-01 14:56:10 -08:00
1 changed files with 23 additions and 11 deletions
@@ -1,21 +1,33 @@
 # Flowy.adhd

-A simple focus app for macOS where you set an intention (one-liner) when you sit down on your computer. And there is an overlay that reminds you to stay on track.
-
-And then you end the session, marking whether this session was a win or loss (e.g. completely distracted). This way, you have a log of your sessions, and you stay focused on one session at a time.
+A macOS focus app that helps you stay on track by setting one intention per session.

 ![app](demo/app.png)
 ![desktop](demo/desktop.png)

-## The goal
-If we are more aware of our intentions when we are on our computer, we can avoid distractions.
+## How it works

-We also do not need much of a todo manager, as that can be productive procrastination. With Flowy.adhd, the entire goal is winning every session, and focusing on one thing at a time.
+1. Set your intention when you sit down at your computer
+2. A persistent overlay keeps your focus visible while you work
+3. End the session and mark it as a win or loss
+4. Build a log of your sessions over time

-## Additional details
- NO sign in
- Local-only data: your sessions are stored as simple markdown files in a local folder
+## Philosophy
+
+Stay aware of your intentions to avoid distractions. No todo manager needed—just focus on winning each session, one thing at a time.
+
+## Features
+
+- **No sign in required** - Start using immediately
+- **Privacy first** - Sessions stored locally as markdown files
+- **Session history** - Review your past wins and losses
+
+## Download
+
+Get the latest version from [releases](https://github.com/flowy-live/adhd/releases).
+
+## Roadmap

-## Future work
 - View past session notes
- Stats visualizer for wins vs. losses
+- Win/loss statistics visualizer
+- Windows and Linux support