Skip to content

Commit c6be173

Browse files
committed
Add Mermaid architecture diagram to Flagship concepts page
1 parent d8c2378 commit c6be173

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

src/content/docs/flagship/concepts.mdx

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,35 @@ Flagship has two paths: a **write path** for managing flags and a **read path**
1313

1414
When you create or update a flag through the dashboard or API, Flagship stores the flag configuration and propagates it to Cloudflare's global network. When your Worker (or SDK) evaluates a flag, the evaluation happens at the edge using the cached configuration — no round-trip to a central server.
1515

16+
```mermaid
17+
flowchart TB
18+
accTitle: Flagship system overview
19+
accDescr: Diagram showing how Flagship works. The write path flows from the dashboard through the control plane worker to a Durable Object and then to KV. The read path flows from the user's Worker through the data plane worker which reads from edge-cached KV and returns an evaluation result.
20+
21+
YourWorker["Your Worker"]
22+
23+
subgraph WritePath["Write path"]
24+
direction TB
25+
Dashboard["Dashboard / API"]
26+
ControlPlane["Flagship control <br/> plane Worker"]
27+
DO[("Durable Object <br/> (source of truth)")]
28+
end
29+
30+
subgraph ReadPath["Read path"]
31+
direction TB
32+
DataPlane["Flagship data <br/> plane Worker"]
33+
end
34+
35+
KV[("KV <br/> (edge-cached config)")]
36+
37+
Dashboard -->|CRUD operations| ControlPlane
38+
ControlPlane -->|config updates| DO
39+
DO -->|store in globally <br/> distributed store| KV
40+
YourWorker -->|binding| DataPlane
41+
DataPlane -->|read flag config| KV
42+
DataPlane -->|eval result| YourWorker
43+
```
44+
1645
The write path and read path are independent. If the dashboard is temporarily unavailable, flag evaluation continues to work using the last propagated configuration.
1746

1847
## Apps

0 commit comments

Comments
 (0)