Skip to content
Alex (Sasha) Zelts de Pape edited this page Apr 20, 2026 · 5 revisions

Acepe Wiki

This wiki is a navigation surface for Acepe documentation.

The canonical architecture source of truth lives in the main repository so it stays versioned with code and pull requests.

%%{init: {'theme':'base','flowchart': {'curve': 'basis', 'nodeSpacing': 28, 'rankSpacing': 34}, 'themeVariables': {'fontFamily': 'Inter, ui-sans-serif, system-ui', 'primaryTextColor': '#1f2937', 'primaryBorderColor': '#9ca3af', 'lineColor': '#6b7280', 'tertiaryColor': '#ffffff', 'background': '#ffffff'}}}%%
flowchart TD
    n_provider("Provider signal") --> n_projection("Backend projection")
    n_projection --> n_sessionGraph("Canonical session graph")
    n_sessionGraph --> n_operations("Operations")
    n_sessionGraph --> n_interactions("Interactions")
    n_operations --> n_stores("Desktop stores")
    n_interactions --> n_stores
    n_stores --> n_views("UI selectors")

    classDef blue fill:#B4D2F0,stroke:#8BA7C0,color:#1f2937,stroke-width:1px;
    classDef green fill:#B4E6C8,stroke:#8FB9A2,color:#1f2937,stroke-width:1px;
    classDef yellow fill:#FFEBB4,stroke:#D8C58E,color:#1f2937,stroke-width:1px;
    classDef orange fill:#FFD2AA,stroke:#D7AE89,color:#1f2937,stroke-width:1px;
    classDef purple fill:#D2BEF0,stroke:#A999C4,color:#1f2937,stroke-width:1px;

    class n_provider,n_projection blue;
    class n_sessionGraph purple;
    class n_operations,n_interactions green;
    class n_stores yellow;
    class n_views orange;
Loading

Architecture reference

Page Role
Home Portal and navigation
Architecture Concepts Reading order and architecture map
Wiki Structure What belongs in the wiki vs the repo docs
Topic Link
Concepts landing page docs/concepts/README.md
Session graph session-graph.md
Operations operations.md
Interactions interactions.md
Reconnect and resume reconnect-and-resume.md

Why the source of truth lives in the repo

Acepe's architecture evolves with code. Keeping the real concept docs in docs/concepts/ means:

  • architecture changes are reviewed in pull requests,
  • docs ship in the same commit as the code they describe,
  • the repo keeps one versioned source of truth for core concepts.

Use this wiki to find the right pages quickly, then follow the repo links for the actual reference.

Clone this wiki locally