Flow-Based, Not Dependency-Based
Trace how operations execute through your system—from UI to API to domain logic to events—not just what imports what.
RivièreLiving Architecture
Extract flow-based architecture from code as living documentation
Skip to content
The Problem
Modern distributed systems span multiple codebases, languages, and domains. Understanding how an operation flows through the system is difficult:
- Static documentation becomes outdated immediately
- Dependency graphs show imports, not operational flow
- Manual diagramming is time-consuming and error-prone
- Cross-codebase tracing requires tribal knowledge
The Solution
Rivière extracts flow-based architecture directly from code. Instead of showing technical dependencies, it traces how operations flow through your system.
text
UI /orders
→ API /bff/orders/place
→ UseCase: Place Order
→ DomainOp: Order.begin()
→ Event: order-placed
→ EventHandler: Prepare ShippingTwo Products
Rivière — Extract
CLI and libraries for extracting architecture from code. Works with AI assistants or programmatically.
Éclair — Visualize
Interactive web app for exploring architecture graphs. Multiple views for different questions.
Choose Your Path
| I want to... | Go here |
|---|---|
| Extract architecture from existing code | AI Extraction Guide |
| Build graphs programmatically | Library Quick Start |
| View an architecture graph | Éclair Guide |
| Understand the schema format | Schema Reference |
Packages
| Package | Description |
|---|---|
@living-architecture/riviere-cli | CLI for AI-assisted extraction |
@living-architecture/riviere-builder | Node.js library for building graphs |
@living-architecture/riviere-query | Browser-safe library for querying graphs |