Local-first architecture as code

Design how your systems work together.

Map applications, integrations, data flows, and infrastructure. Choose C4 Architecture or System Design, then work in readable AAL or a synchronized visual canvas.

System Design

Applications. Data. Events. Infrastructure.

AAL 0.2 + canvas
Uses · connectPlace order · request_responseUpdate customer · writeTake payment · request_responseCustomercustomerCustomer portalapplicationOrders APIapplicationCustomer CRMexternal systemPaymentsexternal system

Connected customer experience

Connect a customer portal, orders, CRM, and payments around one customer journey.

Explore System Design Get started with System Design →

Matching AAL excerpt

aal system-design "0.2"
dictionary "0.2.0"
design Example "Connected customer experience" {
  element Customer "Customer" { type generic.customer }
  element Portal "Customer portal" { type generic.application }
  element Orders "Orders API" { type generic.application }
  element CRM "Customer CRM" { type generic.external_system }
  element Payments "Payments" { type generic.external_system }
  relation Flow1 Customer -> Portal connect "Uses"
  relation Flow2 Portal -> Orders request_response "Place order"
  relation Flow3 Orders -> CRM write "Update customer"
  relation Flow4 Orders -> Payments request_response "Take payment"
}

C4 Architecture

Explain software structure, from context to components.

Get started with C4 →

Two capabilities, familiar ways to work

Write, arrange, explain, and share your design. Choose the project type that answers your audience’s questions.

Architecture as code

Describe software structure or connected systems in readable AAL, using the language for your project type.

Visual authoring

Create, connect, inspect, arrange, and resize architecture elements directly on the canvas.

Source and canvas together

Edit code or the canvas: both stay aligned within each project.

Local-first projects

Keep projects in this browser or choose private cloud storage for access on other devices.

Arrange and present

Use automatic layout to organize a diagram, then Present to focus the conversation on your design.

Portable exports

Export the current diagram as SVG or PNG, or transfer the complete project as versioned JSON.

From software structure to connected systems

Choose your perspective

Use C4 to move through Context, Container, and Component views. Use System Design to map integrations, data flows, events, and infrastructure on one canvas.

Connect the ideas

Keep the projects independent, or import selected C4 software definitions as a snapshot. Refresh deliberately when your software design changes.

Save and share

Save explicitly to this browser or optional private Cloud storage. Present your diagram, export SVG or PNG, or transfer the complete project file.

Bring a diagram, codebase, or idea. Get a tailored prompt and AAL instructions for your own AI assistant, or explore an example.

Getting Started: prompts, examples, and next steps →

Frequently asked questions

Which project type should I choose?

Choose C4 Architecture to explain people, software systems, applications, and components. Choose System Design to map integrations, data pipelines, events, security, observability, delivery, and infrastructure. Each capability has its own project and language.

What is AAL?

Acefy Architecture Language is readable source for your diagrams. C4 Architecture uses AAL C4; System Design uses AAL System Design. You can write source or edit visually, with both kept in sync within each project.

Do I need an account, and where is my work saved?

An account is required to open your project library. Save explicitly: Local means this browser, while Cloud stores up to three private projects for access on other devices. A local save is not a cloud backup. Export a project file for a portable copy; local and cloud clones remain independent.

How do C4 and System Design work together?

Use C4 for software structure and System Design for connected elements, nesting, and interactions. They remain independent projects with their own languages.

Does System Design deploy my resources?

System Design models your platform and its interactions. It does not provision resources, discover a live environment, or verify running infrastructure.

Can an AI assistant help me write AAL?

Download the capability-specific AI instructions from Documentation. For System Design, also attach the resource dictionary. Use them with your external AI assistant, then copy its output into Acefy and inspect diagnostics. There is no in-app AI assistant.

Make your architecture easier to explain

Create an account to start a C4 Architecture or System Design project. Choose Local for this browser or Cloud for access on other devices.

Create account