halkyon-days/halkyon_shared
Archived
Watch
1
0
Fork
You've already forked halkyon_shared
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

halkyon_app: instances, sign-in and sync plumbing for Halkyon's apps

Browse source 
What every Halkyon app's shell needs, taken from Halkyon Learn's and set
on halkyon_base's client: the instances a device keeps an account on,
the first start's tiles and where an instance keeps people's data, the
account switcher; signing in anonymously, with GitHub or an email code,
switching person and the start screen; the gates that build an app's
dependencies per instance and per person; and the sync service with its
status, Settings card and banner. Texts of its own in English and
German take the app's name; what only the app can say, it passes in.
Fakes for apps' tests are in testing.dart.

An instance's basics now name the app it serves (`app`, set by the
host's configuration), and an app accepts only an instance of its own.
SerialQueue and CoalescingRunner move into halkyon_core.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
This commit is contained in:
Tizian 「ティツィアーン」 2026-10-19 15:18:49 +02:00
commit e23cc77f7c
Signed by: raisondetredev
GPG key ID: 07F6FCF405488B64
1 changed files with 10761 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

10
README.md
View file

@ -4,11 +4,15 @@ Shared Dart packages across Halkyon apps, a pub workspace:
- [`halkyon_ui`](packages/halkyon_ui): Halkyon's look, the theme, fonts, layout
and shared widgets (Flutter).
- [`halkyon_app`](packages/halkyon_app): what every app is built around, on an
instance's `halkyon_base`: the instances a device keeps accounts on, signing
in, each person's data opened and closed, and syncing it (Flutter).
- [`halkyon_base`](packages/halkyon_base_server/README.md): what every Halkyon
server has, as a Serverpod module (`halkyon_base_server` and its generated
client `halkyon_base_client`): signing in, the account and its deletion, the
pruning, and the instance's basics.
- [`halkyon_core`](packages/halkyon_core): low-level primitives (pure Dart).
- [`halkyon_core`](packages/halkyon_core): low-level primitives (pure Dart),
`SerialQueue` and `CoalescingRunner` among them.
- [`halkyon_interop`](packages/halkyon_interop): cross-app contracts (pure Dart).
Dart 3.13 and Flutter 3.47, with LeanCode's lints (`leancode_lint`), configured
@ -16,8 +20,8 @@ once in `analysis_options.yaml` here, which every package includes but the
generated `halkyon_base_client`: its analyzer plugin only reaches packages of a
workspace from the root. Run
`flutter pub get` and `dart analyze --fatal-infos` here, and each package's
tests in its folder (`dart test`, or `flutter test` for `halkyon_ui` and its
example). `halkyon_base_server`'s tests start Serverpod's embedded PostgreSQL by
tests in its folder (`dart test`, or `flutter test` for `halkyon_ui`, its
example and `halkyon_app`). `halkyon_base_server`'s tests start Serverpod's embedded PostgreSQL by
themselves and need a git-ignored `config/passwords.yaml` (see its README).
Licences: the server package `halkyon_base_server` is under the Server Side