Onboarding

Chronicle

17 cards ~ 1.3 h Foundational

Foundational walk through the chronicle project. Read top to bottom if you're new; no prior context assumed.

  1. chronicle beginner 4 min

    Two-Service Architecture

    Use when: onboarding to the chronicle-hq monorepo; deciding which service owns a new feature; tracing a request from editor to database

  2. chronicle intermediate 4 min

    ProtocolMessage Envelope

    Use when: adding a new wire message type; debugging an INVALID_MESSAGE error; porting changes to the TypeScript mirror

  3. chronicle intermediate 5 min

    Auth-First WebSocket Handshake

    Use when: debugging AUTH_REQUIRED errors on the relay; adding a new privileged message type; wiring a new identity provider

  4. chronicle intermediate 4 min

    Chronicle JWT Claims & Dev Tokens

    Use when: issuing tokens from an external auth provider; debugging TOKEN_VERIFICATION_FAILED in dev; adding a new authorization claim

  5. chronicle intermediate 5 min

    WebSocket Session Lifecycle

    Use when: adding a new privileged WS handler; debugging clients that never receive broadcasts; tracing why a connection was dropped

  6. chronicle intermediate 6 min

    Hybrid Logical Clock

    Use when: deciding ordering between concurrent operations; investigating a remote clock-skew rejection; encoding HLC into storage

  7. chronicle advanced 7 min

    LSEQ Position IDs

    Use when: investigating runaway position-id growth; debugging concurrent insert ordering; porting the position generator to a new client

  8. chronicle intermediate 5 min

    CRDT Operation Message

    Use when: adding a new operation type; debugging operation_rejected on the relay; implementing client-side optimistic apply

  9. chronicle intermediate 5 min

    Operations & Versions Schema

    Use when: writing a new sync query; designing a snapshot compaction job; debugging slow timeline queries

  10. chronicle advanced 6 min

    Timeline Reconstruction

    Use when: implementing a new timeline UI control; debugging timeline_snapshot returning the wrong content; tuning timeline bucket size for chatty edits

  11. chronicle intermediate 4 min

    Presence Broadcast Channels

    Use when: diagnosing missing cursor updates in the editor; tuning broadcast channel buffer sizes; understanding why presence survives a single missed packet

  12. chronicle beginner 4 min

    Documents REST & SQLite Persistence

    Use when: wiring a new document property; debugging RELAY_DATABASE_URL outside Docker; writing a test that needs a fresh document

  13. chronicle beginner 3 min

    Documents That Remember

    Use when: writing the Chronicle hero or one-line pitch; explaining what category Chronicle is in to someone new

  14. chronicle beginner 4 min

    Four Readers, Four Reasons to Care

    Use when: deciding which segment a campaign asset is speaking to; writing landing-page copy that has to choose a primary reader

  15. chronicle beginner 4 min

    Three Layers: Functional, Emotional, Social

    Use when: deciding whether a post is hooking the right benefit layer for the platform; rewriting marketing speak into Chronicle voice

  16. chronicle beginner 5 min

    Open Beta: Two Weeks, One Asset That Carries Everything

    Use when: explaining the launch arc to an advisor or contributor; deciding whether a campaign asset is on the critical path

  17. chronicle beginner 4 min

    Memory, Not Collaboration: Why Chronicle Is in a Different Category

    Use when: answering 'how is this different from Google Docs?'; framing Chronicle for a developer or buyer who already has a doc tool