Skip to content

docs: refresh for local-first, sync, DID, tables, CMS, and presence - #1253

Draft
joepio wants to merge 1 commit into
developfrom
cursor/docs-refresh-local-first-a1f9
Draft

docs: refresh for local-first, sync, DID, tables, CMS, and presence#1253
joepio wants to merge 1 commit into
developfrom
cursor/docs-refresh-local-first-a1f9

Conversation

@joepio

@joepio joepio commented Aug 4, 2026

Copy link
Copy Markdown
Member

Summary

Public docs lagged the 0.41 local-first release. Spec/protocol pages (websockets.md, Loro commits) were mostly fine; product/GUI docs were thin or missing for the features people actually use now.

This PR drafts the catch-up:

New pages

  • Local-first — OPFS/WASM, encryption, offline, relationship to the server
  • Sync & pairing — devices vs browser tabs, QR pairing, promote-to-server
  • Presence & collaboration — avatars, cursors, follow-me, meetings
  • CMS, drafts & forks — visibility-as-location, Fork merge model, websites, i18n

Rewrites / corrections

  • Tables — views (kanban/calendar/timer), filters, templates, aggregates, computed columns, LocalizedText, presence
  • did.md — remove WIP banner; document pkarr + Iroh as current discovery (Reticulum = planned), not Mainline DHT-as-live
  • Forks (commits/suggestions.md) — replace obsolete HTTP Suggestion/Inbox design
  • Commits intro — drop “prone to change”; note Loro-only writes
  • Overview, feature list, when-to-use, auth examples, sled→redb, 8MB→~70MB, monorepo links
  • TOC (SUMMARY.md) + extended modules list
  • Planning audit: planning/docs-refresh.md

Deferred (called out in the planning doc)

  • @tomic/lib Store / ClientDb deep dive
  • React presence hook docs
  • Broader atomic-data-browser link sweep

Base branch: develop.

Open in Web Open in Cursor 

…resence

Bring public docs in line with the 0.41 local-first release: new pages for
local-first, sync/pairing, presence, and CMS drafts/forks; rewrite tables
and forks docs; fix DID discovery (pkarr/Iroh), WIP banners, sled/8MB/
HTTP-agent leftovers; update TOC and overview.

Co-authored-by: Joep Meindertsma <joep@ontola.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants