Examples

Complete plans from the repository's examples/ directory, live and editable — edit the source on the left and the SVG on the right recompiles instantly (client-side, deterministic). Hit Open in Playground to keep going with the full editor.

Studio (1BR)

The flagship example, and a tour of v1.3: rooms tagged with uses, a cased opening linking the living space to the hall, real fixture symbols (sink, counter, stove, fridge, shower, basin, WC), and doors whose swings stay clear of the furniture. It is lint-clean under the default profile and import-free. Run arch describe / arch lint on it to see the analysis in action.

SOURCE / .ARCH# A compact studio apartment — the canonical ArchLang example. # # Architecturally sound (passes `arch lint`): every room opens off a central hall, # so the bath is never reached through the bedroom; the bath is fully enclosed and # fitted with real fixtures; and no door leaf sweeps onto furniture. Self-contained # (no imports) so it compiles from a single file. plan "Studio 1BR" { units mm grid 50 scale 1:50 north up # Exterior shell + partitions. The x=4000 divider runs the FULL height so the bath # is walled off from the living space; the right column splits into bedroom / hall / bath. wall exterior thickness 200 { (0,0) (7000,0) (7000,6000) (0,6000) close } wall partition thickness 100 { (4000,0) (4000,6000) } wall partition thickness 100 { (4000,3000) (7000,3000) } wall partition thickness 100 { (4000,4400) (7000,4400) } room id=r_living at (0,0) size 4000x6000 label "Living / Kitchen" uses living kitchen room id=r_bed at (4000,0) size 3000x3000 label "Bedroom" uses bedroom room id=r_hall at (4000,3000) size 3000x1400 label "Hall" uses hall room id=r_bath at (4000,4400) size 3000x1600 label "Bath" uses bath # Entrance into the living space; the hall links it to the bedroom and the bath. # Living ↔ hall is a cased opening (circulation needs no door leaf); the bedroom # and bath each get a real door off the hall. door id=d_main at (3000,6000) width 1000 wall exterior hinge left swing in opening id=o_living at (4000,3700) width 900 wall partition door id=d_bed at (6400,3000) width 800 wall partition hinge right swing out door id=d_bath at (4600,4400) width 800 wall partition hinge left swing out window at (0,2000) width 1500 wall exterior window at (7000,1500) width 1200 wall exterior window at (7000,5200) width 700 wall exterior # Kitchen run along the north wall: sink · counter · stove · fridge (drawn as symbols). furniture kitchen_sink at (300,250) size 800x600 furniture counter at (1200,250) size 600x600 furniture stove at (1950,250) size 600x600 furniture fridge at (2700,250) size 600x650 # Living + bedroom furniture, kept clear of the door swings. furniture sofa at (350,4300) size 2000x900 label "Sofa" furniture bed at (4300,300) size 1500x2000 label "Bed" # Bathroom fixtures, kept clear of the door's entry path (the door swings out into # the hall): shower in the far corner, basin against the partition, WC on the south # wall — the left third of the room stays open so you can actually step inside. furniture shower at (6000,5000) size 900x900 # against the E + S walls (corner) furniture basin at (5200,4450) size 600x450 # back to the hall partition furniture wc at (5200,5200) size 400x700 # back to the south wall # Dimension strings: room widths above, overall extents around. The reference # (witness) points sit on the building's OUTER faces (x=-100/7100, y=-100/6100 for # the 200mm shell) so the extension lines start at the wall face and read outward, # never poking back into the building — while the spans still measure centerline to # centerline (4000 · 3000 · 7000 · 6000). dim (4000,-100)->(0,-100) offset 250 text "4000" dim (7000,-100)->(4000,-100) offset 250 text "3000" dim (0,6100)->(7000,6100) offset 500 text "7000" dim (7100,6000)->(7100,0) offset 500 text "6000" title { project "Studio Apartment" drawn_by "ArchCanvas" date "2026-06-27" } }

4 rooms · 3 doors · 3 windows · 42 m²

Two-bedroom flat

A larger plan with a central corridor, multiple rooms, and several openings — absolute placement at a real apartment's scale, with north reoriented.

SOURCE / .ARCH# A two-bedroom apartment with a central corridor. plan "Two-Bedroom Flat" { units mm grid 100 scale 1:100 north right wall exterior thickness 250 { (0,0) (10000,0) (10000,8000) (0,8000) close } wall partition thickness 100 { (4000,0) (4000,5000) } wall partition thickness 100 { (4000,5000) (10000,5000) } wall partition thickness 100 { (7000,5000) (7000,8000) } room id=r_kitchen at (0,0) size 4000x5000 label "Kitchen / Living" room id=r_bed1 at (4000,0) size 6000x5000 label "Master Bedroom" room id=r_bed2 at (0,5000) size 4000x3000 label "Bedroom 2" room id=r_bath at (4000,5000) size 3000x3000 label "Bathroom" room id=r_hall at (7000,5000) size 3000x3000 label "Hall" door at (4000,2500) width 900 wall partition hinge left swing in door at (5500,5000) width 800 wall partition hinge left swing in door at (7000,6500) width 900 wall partition hinge right swing in window at (2000,0) width 2000 wall exterior window at (8000,0) width 2400 wall exterior window at (0,3000) width 1500 wall exterior window at (10000,3000) width 1500 wall exterior furniture bed at (5000,300) size 1800x2100 label "Bed" furniture bed at (300,5300) size 1400x2000 label "Bed" dim (0,8000)->(10000,8000) offset 700 text "10000" dim (0,0)->(0,8000) offset 700 text "8000" title { project "Two-Bedroom Flat" drawn_by "ArchCanvas" date "2026-06-25" } }

5 rooms · 3 doors · 4 windows · 80 m²

Parametric

Uses let bindings, a value-function, an array, a scoped set, a for loop, and string interpolation to generate a row of repeated units — showing that scripting expands at compile time into a fixed, deterministic drawing.

SOURCE / .ARCH# Parametric plan (v0.8 scripting): a row of studio units generated with a # `for` loop over a range, a value-function, an array indexed per unit, a scoped # `set` rule, an `if`, and string-interpolated labels. Everything is derived # from the constants — change COUNT and the whole row regenerates. plan "Parametric — Studio Row" { units mm grid 50 scale 1:100 north up # Plan-level constants (visible everywhere below — plan scope is global). let WALL = 200 let W = 4000 # unit width let H = 5000 # unit depth let DOOR = 900 let WIN = 1600 let COUNT = 3 # number of units # A value-function (pure closure) — area in square metres. let aream2(w, h) = w * h / 1000000 # Per-unit names, indexed by the loop variable. let names = ["Studio A", "Studio B", "Studio C"] # Entrance doors swing outward throughout this plan (scoped default). set door(swing: out) for i in 0..COUNT { let x = i * W wall exterior thickness WALL { (x, 0) (x + W, 0) (x + W, H) (x, H) close } room at (x, 0) size W x H label "{names[i]}" furniture bed at (x + 300, 300) size 1500x2000 label "Bed" furniture kitch at (x + W - 1900, 300) size 1600x600 label "Kitchen" door at (x + W / 2, H) width DOOR wall exterior hinge left window at (x + W / 2, 0) width WIN wall exterior # The end unit carries a per-unit area dimension (computed by the function). # Referenced to the outer face (y = H + WALL/2) so the extension lines start at # the wall and read downward, away from the building. if i == COUNT - 1 { dim (x, H + WALL / 2)->(x + W, H + WALL / 2) offset 600 text "{aream2(W, H)} m² each" } } # Overall run, dimensioned above the building: right-to-left so the offset lands # ABOVE the row (outside), and referenced to the outer top face (y = -WALL/2). dim (W * COUNT, 0 - WALL / 2)->(0, 0 - WALL / 2) offset 1300 text "{COUNT} units" }

3 rooms · 3 doors · 3 windows · 60 m²

Themed

A custom theme { … } block with a brick wall material (hatch) — the same geometry, restyled. See theming and materials.

SOURCE / .ARCH# Theming + materials: a two-room plan with a brick exterior, a partition, # and a dark "blueprint" theme. Try CompileOptions.theme to override at runtime. plan "Themed Duplex" { units mm grid 50 scale 1:100 north up theme { background: "#1e2127" wall: "#e8e8e8" wallFill: "#3a3f4b" wallHatch: "#5a6172" room: "#272b33" roomLabel: "#f0f0f0" areaLabel: "#9aa0aa" furniture: "#2f343d" dim: "#6cb6ff" annotation: "#cfd3da" font: "Georgia, serif" lineWeight: 1.3 } let W = 6000 let H = 4000 wall exterior thickness 250 material brick { (0,0) (W,0) (W,H) (0,H) close } wall partition thickness 100 { (3000,0) (3000,H) } room id=a at (0,0) size 3000x4000 label "Living" room id=b at (3000,0) size 3000x4000 label "Bedroom" furniture bed at (3300,300) size 1500x2000 label "Bed" door at (3000,2000) width 900 wall partition hinge left swing in window at (1500,0) width 1600 wall exterior window at (4500,0) width 1200 wall exterior dim (0,H)->(W,H) offset 600 text "6000" }

2 rooms · 1 doors · 2 windows · 24 m²

Relational

Rooms positioned relative to one another with right-of / below, align, and gap — resolved to absolute coordinates by deterministic arithmetic, not an optimizer (see relational placement).

SOURCE / .ARCH# Relational placement (v1.0): rooms positioned relative to one another with # `right-of` / `left-of` / `below` / `above` (+ `align` and `gap`), resolved to # absolute coordinates by pure arithmetic in dependency order. Only `living` is # anchored with `at`; every other room derives its position from a neighbour, so # changing the anchor or a size reflows the whole plan deterministically. plan "Relational 1BR" { units mm grid 50 scale 1:100 north up # Exterior shell (walls are always absolute — relational placement is rooms-only). wall exterior thickness 200 { (0,0) (8000,0) (8000,7500) (0,7500) close } room id=living at (0,0) size 5000x4000 label "Living" room id=kitchen right-of living align top gap 0 size 3000x4000 label "Kitchen" room id=bed below living align left gap 0 size 5000x3500 label "Bedroom" room id=bath right-of bed align top gap 0 size 3000x3500 label "Bath" door at (1000,0) width 1000 wall exterior hinge left swing in window at (6500,0) width 1800 wall exterior furniture bed at (300,4300) size 1500x2000 label "Bed" dim (0,7500)->(8000,7500) offset 600 text "8000" title { project "Relational Layout Demo" drawn_by "ArchCanvas" date "2026-06-26" } }

4 rooms · 1 doors · 1 windows · 60 m²

Attached (placement sugar)

A one-bedroom flat with no hand-computed coordinates for its openings or furniture. It exercises the v1.13 placement sugar together: a strip laying rooms out end to end, doors and windows attached to a wall by position (on <wall> at <pos> — so they can never be reported "off wall"), a door that opens toward a named room (swing into), and furniture anchored inside a room (in <room> anchor … inset …).

SOURCE / .ARCH# A one-bedroom flat authored with the v1.13 placement sugar — no hand-computed # coordinates for openings or furniture. It exercises, together: # • `strip` — a row of rooms laid out end to end # • openings attached to a wall by position (`door|window … on <wall> at <pos>`) # • a door that opens toward a named room (`swing into`) hinged at a wall end # • furniture placed relative to a room (`in <room> anchor …`) # Compiles clean and passes `arch lint`. plan "Attached 1BR" { units mm grid 100 north up # Living + bedroom laid left-to-right by a strip, sharing a 4 m depth. strip right at (0,0) gap 0 height 4000 { room id=r_living size 4000 label "Living" uses living room id=r_bed size 3000 label "Bedroom" uses bedroom } # Exterior shell as four straight walls (each a clean start→end to attach onto) # plus the partition between the two rooms. wall id=w_north exterior thickness 200 { (0,0) (7000,0) } wall id=w_south exterior thickness 200 { (0,4000) (7000,4000) } wall id=w_west exterior thickness 200 { (0,0) (0,4000) } wall id=w_east exterior thickness 200 { (7000,0) (7000,4000) } wall id=w_part partition thickness 100 { (4000,0) (4000,4000) } # Entrance 2000 mm along the south wall, hinged at that wall's start end and # opening into the living room. The bedroom door on the partition opens inward. door id=d_main on w_south at 2000 width 1000 hinge near start swing into r_living door id=d_bed on w_part at 2000 width 900 swing into r_bed # A window centred on each room's exterior wall. window on w_west at 50% width 1400 window on w_east at 50% width 1200 # Furniture placed by anchor inside each room (never off a coordinate). furniture sofa in r_living anchor top-left inset 300 size 2000x900 label "Sofa" furniture bed in r_bed anchor right inset 300 size 1500x2000 label "Bed" }

2 rooms · 2 doors · 2 windows · 28 m²

Accessible metadata

accTitle and accDescr supply the SVG <title>/<desc> emitted by arch compile --accessible. They are metadata only — the default output is byte-identical without the flag. Omit them and the description is derived from describe()'s caption instead.

SOURCE / .ARCH# Accessible metadata demo — `accTitle` / `accDescr`. # # These two plan-level keywords supply the accessible SVG `<title>` and `<desc>` # used by `arch compile --accessible` (and `compile(src, { accessible: true })`). # They OVERRIDE the defaults: `accTitle` replaces the plan name in `<title>`, and # `accDescr` replaces the auto-derived describe() caption in `<desc>`. Default # (non-accessible) output is unaffected — this is metadata only. plan "Flat 2B" { units mm grid 50 north up accTitle "Two-room flat — accessible floor plan" accDescr "A small flat: a living room with the entrance, and a bedroom off it, joined by a single interior door." wall exterior thickness 200 { (0,0) (6000,0) (6000,4000) (0,4000) close } wall partition thickness 100 { (3500,0) (3500,4000) } room id=r_living at (0,0) size 3500x4000 label "Living" uses living room id=r_bed at (3500,0) size 2500x4000 label "Bedroom" uses bedroom door id=d_main at (1500,0) width 1000 wall exterior hinge left swing in opening id=o_int at (3500,2000) width 900 wall partition window at (5000,4000) width 1200 wall exterior }

2 rooms · 1 doors · 1 windows · 24 m²