From 281d805ef946b97a672352093525976ee5505ccb Mon Sep 17 00:00:00 2001
From: Julien Calixte <julien.calixte@theodo.com>
Date: Tue, 30 Jun 2026 22:46:43 +0200
Subject: [PATCH] docs: add .remanso.json (monospace, 500px), align ASCII, drop
 mermaid

---
 .remanso.json | 18 ++++++++++++++
 README.md     | 67 +++++++++------------------------------------------
 2 files changed, 29 insertions(+), 56 deletions(-)
 create mode 100644 .remanso.json

diff --git a/.remanso.json b/.remanso.json
new file mode 100644
index 0000000..7cfe246
--- /dev/null
+++ b/.remanso.json
@@ -0,0 +1,18 @@
+{
+  "fontFamilies": [
+    "Cutive Mono",
+    "Google Sans Code",
+    "Inconsolata",
+    "Libertinus Mono",
+    "Lilex",
+    "Source Code Pro"
+  ],
+  "fontSize": "15pt",
+  "pageWidth": "500px",
+  "backlink": false,
+  "atmosphere": {
+    "contentDir": ".",
+    "publicationUri": "at://did:plc:4m3kouplb7s7xozjd3whinvl/site.standard.publication/3mdteq7ldoc2i",
+    "pdsUrl": "https://eurosky.social"
+  }
+}
diff --git a/README.md b/README.md
index 5e471dc..11907cf 100644
--- a/README.md
+++ b/README.md
@@ -72,8 +72,6 @@ You'll leave understanding what atproto actually *is*, and with a realistic path
 
 One source of truth (your files), one network you own (the protocol), many lenses to read it (the apps).
 
-### ASCII
-
 ```text
         FILE  ───▶  PROTOCOL  ───▶  APP
        (own it)    (share it)      (read it — many lenses, one source)
@@ -96,71 +94,28 @@ One source of truth (your files), one network you own (the protocol), many lense
    └───────────────┬──────────────┘
                    │  com.atproto.repo.createRecord
                    ▼
-   ┌────────────────────────────────────────────────┐
+   ┌──────────────────────────────────────────────────┐
    │ PROTOCOL — your PDS   (records you own)          │
-   │ identity: did:plc:… + handle   (via plc.directory)│
+   │ identity: did:plc:… + handle  (plc.directory)    │
    │ addressed by DID + rkey:                         │
-   │   site.standard.document   shared → reach/interop│
-   │   space.remanso.note       custom → rich render  │
-   └────────┬──────────────────────────────┬──────────┘
-            │ firehose / Jetstream         │ listRecords (read)
-            ▼                              ▼
-   ┌─────────────────────────┐   ┌───────────────────────────────┐
-   │ remanso-jetstream       │   │ APP — many lenses, one source │
+   │   site.standard.document   shared → reach        │
+   │   space.remanso.note       custom → rich         │
+   └────────────┬─────────────────────────────────┬───┘
+                │ firehose / Jetstream            │ listRecords (read)
+                ▼                                 ▼
+   ┌─────────────────────────┐   ┌────────────────────────────────┐
+   │ remanso-jetstream       │   │ APP — many lenses, one source  │
    │ AppView (self-hosted)   │   │  Remanso (remanso.space)       │
    │ Jetstream→SQLite→REST   │──▶│    + Bluesky graph (getFollows)│
-   └─────────────────────────┘   │  apoena.dev (static · îles)    │
+   └─────────────────────────┘   │  apoena.dev (static site)      │
                                  │  Leaflet / any standard.site   │
      reuse the Bluesky graph ───▶│  Bluesky & other atproto apps  │
-     app.bsky.graph.getFollows   └───────────────────────────────┘
+     app.bsky.graph.getFollows   └────────────────────────────────┘
 
    Self-hosted on Coolify (platform.apoena.dev) + Gitea (git.apoena.dev).
    GitHub = push mirror.
 ```
 
-### Mermaid
-
-```mermaid
-flowchart TD
-    subgraph FILE["📄 FILE — own it"]
-        IDE["Markdown notes in your IDE<br/>Zettelkasten: notes + backlinks<br/>~800 notes, private Git repo"]
-        PUB["note.pub.md<br/>suffix + commit = publish"]
-        IDE --> PUB
-    end
-
-    CLI["remanso-cli — fork of Sequoia<br/>local CLI or GitHub Action<br/>change-detect · images→blobs · atUri write-back"]
-
-    subgraph PROTO["🌐 PROTOCOL — share it · atproto"]
-        PDS["Your PDS — records you own<br/>identity: did:plc:… + handle"]
-        L1["site.standard.document<br/>shared → reach / interop"]
-        L2["space.remanso.note<br/>custom → rich rendering"]
-        PDS --- L1
-        PDS --- L2
-    end
-
-    JET["remanso-jetstream<br/>AppView (self-hosted)<br/>Jetstream → SQLite → REST"]
-
-    subgraph APP["🪟 APP — read it · many lenses, one source"]
-        REM["Remanso — remanso.space<br/>+ Bluesky graph (getFollows)"]
-        APO["apoena.dev — static site (îles)"]
-        LEAF["Leaflet / any standard.site reader"]
-        BSKY["Bluesky & other atproto apps"]
-    end
-
-    PLC["plc.directory<br/>resolve DID → PDS"]
-    GRAPH["app.bsky.graph.getFollows"]
-
-    PUB -->|git push| CLI
-    CLI -->|com.atproto.repo.createRecord| PDS
-    PLC -.resolve.-> PDS
-    PDS -->|firehose / Jetstream| JET
-    JET -->|REST| REM
-    PDS -->|listRecords at build time| APO
-    L1 -.read.-> LEAF
-    PDS -.public on the network.-> BSKY
-    GRAPH -.reuse the Bluesky graph.-> REM
-```
-
 > The whole stack is self-hosted: **Coolify** (`platform.apoena.dev`) runs the AppView and apps, **Gitea** (`git.apoena.dev`) hosts the code, with **GitHub** as a push mirror.
 
 ---