notes

2.1 KB

1. # notes.worldapi.org — concept
3. A notes app in Hybriel (hl:web), login via ident, offline-first later. Replaces the old `demo-notes` PWA that runs at
4. notes.worldapi.org since 2026-08-31 (port 45000). Source of truth = the creator's words; "Decisions" are the architect's.
6. ## The creator's words (chat, 2026-09-25, verbatim)
8. > next i want to do the notes app. in parallel we can do the notes.worldapi.org app. we already have the md wysiwyg. the
9. > notes have a sidebar listing the subject of the notes, ordered by last one edited. if you click on a note in the
10. > sidebar it appears on the right in main. the notes app is then also an offline use case later. notes need to be saved
11. > locally in the indexed db, and picked from that cache when offline. when back online it syncs with the server and
12. > possible other changes made on other devices. there are already several demo apps for the notes case, but the
13. > language and the framework shifted since then.
15. > yes go ahead. make decisions on your own. if i dont like something i will request changes afterwards
17. ## Steps (one ticket each, in this order)
18. 1. Notes with ident login: sidebar = subjects of my notes, last edited first; click → the note on the right in main;
19. new note, edit with the Markdown WYSIWYG editor, delete. Saved on the server.
20. 2. Offline: notes saved in the browser's IndexedDB, read from there when offline, edits offline; back online → sync with
21. the server and with changes from other devices.
23. ## Decisions (architect, 2026-09-25 — changeable)
24. - The subject = the note's first line / first heading (no separate title field).
25. - The editor = the existing `<md-editor>` (worldapi-components, used by tickets) until it becomes a Hybriel component on
26. components.hybriel.worldapi.org.
27. - The old demo apps (hybriel/projects/demo-notes*) are reference only; built fresh on today's hl:web.
28. - Storage hl:mpackdb in `storage/mpackdb/`, `@id` keys. New app on 127.0.0.1:45007, container `notes.worldapi.org`
29. replaces the demo: at the first deploy the architect backs up the demo, stops it and points the vhost to 45007.
30. - Sync conflicts (step 2): last write wins per note, the losing version is kept as a copy so nothing is lost.