Radical Studio — Architecture Model
Radical Studio, the architecture studio of the open-source radical.tools family, inside VS Code.
One living model of your system, for your team and your coding agents: C4, decisions, requirements and fitness functions together. Free and MIT licensed.
Features
- Visual drag-and-drop editor for
.radical files — opens automatically on double-click
- Two metamodels — the Radical metamodel (C4 with DDD domains, ADRs, Fitness Functions, Needs, Requirements, Scenarios, Mockups and State Machines) or plain C4
- Multiple views per model — Canvas, Treemap, Matrix, Sequence, Table, Wiki — all driven from one source of truth
- JSON Schema validation — IntelliSense, autocomplete and error highlighting for
.c4.json files
- Live VS Code theme sync — diagram UI automatically follows your editor's light / dark theme
- Two-way file sync — edit the raw JSON in any external editor; changes appear instantly in the diagram
- AI assistant — describe changes in plain language; the AI patches the model (requires API key)
- Undo / redo, snapshots, milestone tracking, presentations
Getting Started
New diagram
- Create a file ending in
.radical (e.g. architecture.radical)
- VS Code opens it automatically in Radical.Tools
- The editor initialises with the Radical metamodel — the fuller of the two
- Add nodes from the left-panel palette and connect them on the canvas
Existing .c4.json file
Open the file in the text editor, then click the ⎈ button in the editor title bar to open the visual editor alongside it.
Requirements
The diagram engine is fully bundled with the extension — no additional software or internet access is needed.
Configuration
| Setting |
Default |
Description |
radical.projectRoot |
(workspace root) |
Override the project root used to locate a local source build. Leave empty for the bundled engine. |
radical.npmPath |
npm |
Path to npm — only relevant when building the engine from source. |
| Extension |
Behaviour |
.radical |
Opens directly in the Radical.Tools visual editor (custom editor, default priority) |
.c4.json |
Opens as JSON with schema validation; use the ⎈ toolbar button to open the visual editor |
Commands
| Command |
Description |
Radical.Tools: Open current file |
Open the active .c4.json in the visual editor |
Radical.Tools: Open app |
Open the visual editor without a file |
Radical.Tools: Stop |
Close all Radical.Tools panels |
Radical.Tools: Show output log |
Show the extension output channel |
Three built-in presets ship with the extension:
| Preset |
Node types included |
| Radical |
All C4 types + recursive Domain container, Entity, ADR, Fitness Function, Need, Requirement, Scenario, Blueprint, Mockup, State Machine |
| C4 |
Person, System, Container, Component, Database, Web App, Queue, Group |
New files are initialised with the Radical metamodel. Files made with the former C4 + DDD preset open under it, since it holds all of their types.
The metamodel can be customised per-document with the metamodel editor button on the activity rail.
License
MIT
| |