C4 views, layout, and export
Create Context, Container, and Component views, control layout and filtering, and export C4 diagrams as SVG, PNG, or project JSON.
Acefy Architecture Language (AAL) · AAL C4 0.2 · Level-aware semantics

Context View
Shows all persons and systems at the top level. No containers or components are visible. This is the highest-level C4 view.
view context { ... }view context {
title "Platform — System Context"
layout left-to-right
}Container View
Shows all containers within a specific software system, plus external dependencies. Requires a system target. Supports include/exclude filtering.
view container <system> { ... }view container BankingPlatform {
title "Banking — Container Architecture"
layout left-to-right
include Customer
exclude AuditSystem
}Component View
Shows all components within a specific container, plus external dependencies. Requires a container target. Supports include/exclude filtering. Component views can be dense — use compact rendering.
view component <container> { ... }view component BankingAPI {
title "Banking API — Component Architecture"
layout top-to-bottom
}Include / Exclude
Views support optional include and exclude directives:
view container Platform {
title "Platform — Container Architecture"
layout left-to-right
include Customer
include Identity
exclude AuditSystem
}include <ElementId>Forces inclusion of an element in the view, even if it would not normally appear. Useful for showing external systems or people in a container view.exclude <ElementId>Removes an element from the rendered view. Explicit exclude overrides automatic relevance inclusion. The view target can never be excluded.Layout
AAL view declarations support a layout direction, and the Designer exposes the current layout direction in the toolbar:
left-to-rightElements flow from left to right. Best for container views with horizontal relationships.top-to-bottomElements flow from top to bottom. Best for hierarchical or layered views.Component views can be dense — the renderer uses compact node sizing for components automatically.
In the visual Designer, the level selector shows Context, Container, and Component views. The toolbar direction control drives the rendered layout; parsed view filters are still honored for the matching level.
Export (PNG / SVG / Project)
PNG and SVG export faithfully reproduce the current Designer layout. No Auto Layout is run during export — the export consumes the current rendered state.
Export Project (.acefy.json) — choose Export… from the top-right Export menu (More on compact screens), then choose Project in the export dialog. The downloaded file includes the project name, AAL source, selected view, and layout configuration; the model is rebuilt from AAL on import.
Exports preserve:
- Node positions and group boundary dimensions
- Hierarchy (System → Container → Component)
- Per-relationship edge styles (Orthogonal / Curved / Straight)
- Source and target attachment sides
- Relationship label positions
- Object colors
- Canvas background
Export uses the currently selected view (Context, Container, or Component). Only the architecture diagram is exported — no toolbar, editor, or inspector UI.