docs: the phone client, and the Glyph traps worth not re-learning
The android README still described the app as unbuilt and pointed `glyph/libs/` at a path that does not exist. It now covers what the app is made of, how to get the SDK, and the three Glyph behaviours that cost an afternoon — two of which fail with no exception and no log at all. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
3 files changed
+84
-19
No files matched your search
@@ -11,6 +11,7 @@ Three pieces, one backend:
|
||||
| **Backend** | FastAPI + Postgres: the clock, the task mirror, the blocking policy, the reports, the Telegram bot | Docker |
|
||||
| **Web app** | React + Material UI — the whole thing in a browser, on any device | Docker (same container) |
|
||||
| **Desktop app** | A **native Qt/QML** app: tray, D-Bus, real notifications, and the part that actually blocks websites and apps | Your machine |
|
||||
| **Android app** | A native Compose client for the Nothing Phone (3): the interval as an Android 16 Live Update, and the countdown on the rear Glyph Matrix | Your phone |
|
||||
|
||||
The server owns the clock. Start a pomodoro on your phone's browser, watch it
|
||||
count down in the tray, finish it from the desktop — it is one interval.
|
||||
@@ -212,6 +213,9 @@ and you can fill everything in from **Settings**.
|
||||
come from a separate, validated data palette: the brand is warm, but a chart
|
||||
has to stay readable for colour-blind readers in both themes.
|
||||
* `desktop/` — the native app. See [`desktop/README.md`](desktop/README.md).
|
||||
* `android/` — the phone client. Everything with interesting behaviour lives in a
|
||||
plain-JVM `:core` module, so 225 tests run on a laptop with nothing but a JDK. See
|
||||
[`android/README.md`](android/README.md).
|
||||
|
||||
---
|
||||
|
||||
@@ -225,6 +229,8 @@ make desktop # run the native app from the checkout
|
||||
make desktop-install # menu entry + icon
|
||||
make helper-install # the privileged blocking helper
|
||||
make report # build and send today's report right now
|
||||
make android-install # build and install the phone client
|
||||
make deploy # push master and redeploy kadence.timka.su
|
||||
```
|
||||
|
||||
The backend also has a CLI, handy from cron or a systemd timer:
|
||||
|
||||
Reference in new issue
Block a user