docs: add .remanso.json (monospace, 500px), align ASCII, drop mermaid
This commit is contained in:
18
.remanso.json
Normal file
18
.remanso.json
Normal file
@@ -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"
|
||||||
|
}
|
||||||
|
}
|
||||||
61
README.md
61
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).
|
One source of truth (your files), one network you own (the protocol), many lenses to read it (the apps).
|
||||||
|
|
||||||
### ASCII
|
|
||||||
|
|
||||||
```text
|
```text
|
||||||
FILE ───▶ PROTOCOL ───▶ APP
|
FILE ───▶ PROTOCOL ───▶ APP
|
||||||
(own it) (share it) (read it — many lenses, one source)
|
(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
|
│ com.atproto.repo.createRecord
|
||||||
▼
|
▼
|
||||||
┌────────────────────────────────────────────────┐
|
┌──────────────────────────────────────────────────┐
|
||||||
│ PROTOCOL — your PDS (records you own) │
|
│ PROTOCOL — your PDS (records you own) │
|
||||||
│ identity: did:plc:… + handle (via plc.directory)│
|
│ identity: did:plc:… + handle (plc.directory) │
|
||||||
│ addressed by DID + rkey: │
|
│ addressed by DID + rkey: │
|
||||||
│ site.standard.document shared → reach/interop│
|
│ site.standard.document shared → reach │
|
||||||
│ space.remanso.note custom → rich render │
|
│ space.remanso.note custom → rich │
|
||||||
└────────┬──────────────────────────────┬──────────┘
|
└────────────┬─────────────────────────────────┬───┘
|
||||||
│ firehose / Jetstream │ listRecords (read)
|
│ firehose / Jetstream │ listRecords (read)
|
||||||
▼ ▼
|
▼ ▼
|
||||||
┌─────────────────────────┐ ┌───────────────────────────────┐
|
┌─────────────────────────┐ ┌────────────────────────────────┐
|
||||||
│ remanso-jetstream │ │ APP — many lenses, one source │
|
│ remanso-jetstream │ │ APP — many lenses, one source │
|
||||||
│ AppView (self-hosted) │ │ Remanso (remanso.space) │
|
│ AppView (self-hosted) │ │ Remanso (remanso.space) │
|
||||||
│ Jetstream→SQLite→REST │──▶│ + Bluesky graph (getFollows)│
|
│ Jetstream→SQLite→REST │──▶│ + Bluesky graph (getFollows)│
|
||||||
└─────────────────────────┘ │ apoena.dev (static · îles) │
|
└─────────────────────────┘ │ apoena.dev (static site) │
|
||||||
│ Leaflet / any standard.site │
|
│ Leaflet / any standard.site │
|
||||||
reuse the Bluesky graph ───▶│ Bluesky & other atproto apps │
|
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).
|
Self-hosted on Coolify (platform.apoena.dev) + Gitea (git.apoena.dev).
|
||||||
GitHub = push mirror.
|
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.
|
> 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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
Reference in New Issue
Block a user