Rivière

Appearance

RivièreLiving Architecture

Extract flow-based architecture from code as living documentation

Get Started
View Demo
GitHub
Éclair architecture visualization

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.

Flexible Extraction

AI-assisted extraction works for any codebase. Config-based extraction provides speed and repeatability when you follow architectural conventions.

Interactive Visualization

Explore your architecture in Éclair. Filter by domain, trace flows, compare versions, and understand your system at any level.

100% Open Source

Apache 2.0 licensed. Use it, fork it, contribute. Built in the open on GitHub.

How It Works ​

Workflow: Your Code → Extract → Rivière Schema → Visualize in Éclair

Rivière Schema ​

A JSON format that captures how operations flow through your system — from UI to API to domain logic to events. Not just what imports what, but how things actually work.

Learn the Schema →

Rivière CLI ​

Point an AI assistant at your codebase. It calls CLI commands to analyze your code and build a Rivière schema.

CLI Guide →

Rivière Builder ​

Build schemas programmatically in TypeScript. Integrate into build pipelines or create custom extraction tools.

Library Guide →

Éclair ​

Load your schema into Éclair. Filter by domain, trace flows end-to-end, see which services publish and subscribe to events.

Explore the Demo →

Rivière Flow-Based Schema ​

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 Shipping

See It In Action ​

Flow view showing an operational flow through multiple domains
Trace an operational flow end-to-end
Domain map showing dependencies between domains
Visualize domain dependencies

Run Locally ​

Clone the repo and run Éclair with the demo graph.

bash
git clone https://github.com/NTCoding/living-architecture.git
cd living-architecture
pnpm install
pnpm nx serve eclair

Open http://localhost:5173/eclair/

Choose Your Path ​

I want to...Go here
Extract architecture from existing codeAI Extraction Guide
Build graphs programmaticallyLibrary Quick Start
View an architecture graphÉclair Guide
Understand the schema formatSchema Reference
Try it with a demo graphView Demo
Run Éclair locallyRun Locally

Packages ​

PackageDescription
@living-architecture/riviere-cliCLI for extraction and graph building
@living-architecture/riviere-builderNode.js library for building graphs
@living-architecture/riviere-queryBrowser-safe library for querying graphs
@living-architecture/riviere-extract-configExtraction config schema and validation
@living-architecture/riviere-extract-conventionsTypeScript decorators for component marking
@living-architecture/riviere-extract-tsTypeScript component extractor