# Halkyon Meditate

Meditation, as a Halkyon app (ADR 0038): a silent timer with bells, Halkyon's own
guided practices as text cues, found by goal and kind, and the person's minutes, days
and days in a row, every sitting sealed and synced between their devices. People choose
an instance, sign in (with SimpleLogin or a password), switch between the accounts on
their devices, sign out and delete their account, as in every Halkyon app.

| Package | What it is |
|---|---|
| [`halkyon_meditate_server`](halkyon_meditate_server/) | The server: Serverpod with the `halkyon_base` module and the sync engine |
| [`halkyon_meditate_client`](halkyon_meditate_client/) | Its client, generated by Serverpod |
| [`halkyon_meditate_flutter`](halkyon_meditate_flutter/) | The app, on `halkyon_app` and `halkyon_ui` (Android, iOS, Linux, macOS, Windows) |

Run it with `serverpod start` in `halkyon_meditate_server`, which starts the server (and its
embedded PostgreSQL) and the app; or the app alone against an instance with
`flutter run --dart-define=SERVER_URL=https://…/` in `halkyon_meditate_flutter`. Tests:
`dart run melos run test:dart --scope=halkyon_meditate_server` and
`dart run melos run test:flutter --scope=halkyon_meditate_flutter` at the repository's
root, or `dart run tool/check.dart` for everything.

The app's icon is [Lucide](https://lucide.dev)'s `sprout` (ISC licence, ADR 0031),
drawn by the repository's `tool/app_icons.py`. Its bells are synthesised by
[`tool/bells.py`](tool/bells.py) and are the project's own. Licences: the server under
the SSPL, the client and the app under the AGPL ([`LICENSE.md`](../../LICENSE.md)).