ArchLang Playground

Hillside Villa — an ArchLang floor plan example

A two-storey villa with an attached garage on one A2 sheet — the whole language in a single plan.

Level 1 (Ground floor) compiles to 11 rooms, 196.54 m² of floor area and 10 windows; every room is reachable from the entrance.

Drive 16.5 m² 1 2 3 4 5 A B C D UP Garage 34.1 m² Utility 22.0 m² Powder 4.4 m² Pantry 8.4 m² Study 16.5 m² Entry 16.8 m² Living 28.8 m² Dining 19.2 m² Kitchen 23.2 m² Terrace 11.6 m² Service Hall 11.6 m² Terrace 5.8 x 2.0 m 3000 2500 900 2550 1000 3800 1800 7050 4000 4000 2000 3800 19600 2600 1600 6000 10500 550 4800 650 700 400 700 400 700 2150 1200 4750 900 1700 4000 4000 2000 3800 19600 2900 900 950 1200 300 1000 1400 1400 450 2600 1600 6000 10500 R2000 100 200 300 ROOM SCHEDULE NO. NAME AREA (CENTRELINE, m²) NET AREA (m²) Service wing 01 Garage 34.10 30.94 02 Utility 22.00 19.50 03 Powder 4.40 3.80 04 Pantry 8.36 7.20 SUBTOTAL 68.86 61.44 Living wing 05 Study 16.48 14.80 06 Entry 16.80 15.41 07 Living 28.80 26.54 08 Dining 19.20 17.44 09 Kitchen 23.20 21.28 10 Terrace 11.60 9.71 11 Service Hall 11.60 10.36 SUBTOTAL 127.68 115.54 TOTAL 196.54 176.98 LEGEND poche tarmac wc basin kitchen_sink counter stove fridge armchair coffee_table tv_unit dining_table barstool desk office_chair bookshelf dishwasher island upper_cabinet washer dryer plant car rug sofa_l piano sun_lounger N 01 m PROJECTHillside VillaDRAWN BYArchLangDATE2026-08-27SCALE1:50LEVEL1 — Ground floor
"Hillside Villa" — a 2-level floor plan, 22 rooms, 337.3 m² total; level 1 "Ground floor" (11 rooms, 196.54 m², 13 doors, 10 windows; entrances via d_front, d_garage, and 2 more): Garage (34.1 m²), Utility (22 m²), Powder (4.4 m²), Pantry (8.36 m²), Study (16.48 m²), Entry (16.8 m²), Living (28.8 m²), Dining (19.2 m²), and 3 more.

This is a 2-level plan: a storey is a drawing, so the compiler produces one sheet per level and the drawing above is level 1. The command line writes one file per level, and the playground's preview has a storey switcher. Each storey measures:

Open in the editor

What this plan uses

The parts of the language this plan's source writes, each linked to its section of the language reference.

The source

This is the whole plan. The drawing above is what the compiler produced from it — nothing was drawn by hand.

# The SHOWPIECE flagship — a two-storey hillside villa with an attached garage, the plan a
# first-time visitor to the language should see. Everything else in examples/ is one
# thing done well; this one is the whole language on one sheet. Surfaces it exercises:
# `site` (five derived compass names) · `paper`+`scale`+`axes`+`schedule`+`legend` (a real
# sheet with a title block) · `zone` (living/service/sleeping wings, rolled up in the
# schedule subtotals) · `room polygon` (a chamfered nook off the study) · `arc` wall edge
# (a bowed bay off the living room) · all SIX door kinds —
# the five that have to be named (sliding/pocket/bifold/barn/garage), plus the `hinged`
# default on the rest, each where a builder would actually put it. The `door` lines show
# five, because `hinged` is never written; `arch describe --json` reports the kind on
# every door · `window on <wall> at <pos>` plus a `for` loop (a street-facing ribbon of
# study windows) · `level 1`/`level 2` · `stair` (same id both levels, one shaft) · `void`
# (a double-height gap over the living room) · `roof overhang` (the eaves, drawn on the upper
# storey) · `component` + `place … mirror x` (a mirrored pair of ensuite bathrooms) · ~30
# furniture families across kitchen/living/bedroom/study/garage/terrace · `dims auto all`
# plus two manual dims.
#
# The plot fronts the street on the NORTH, in the northern hemisphere — so `back` and
# `equator_side` are the SAME side (south), which is why the living room, the arc bay and
# both bedrooms take the south facade, and the garage/service band
# stacks along the street. `site` draws nothing; it only names directions.
plan "Hillside Villa" {
  units mm
  grid 100
  paper A1 landscape
  scale 1:50
  north up
  dims auto all
  schedule rooms
  legend

  site { street north hemisphere north }

  # A mirrored PAIR of ensuite bathrooms, authored once. `place ensuite() as <name> at
  # (x,y) [mirror x]` instantiates it as an addressable box (its own wall + room + three
  # wet fixtures); the parent cuts each suite's own door by a dotted reference into the
  # instance's wall (`en2.wall`, `en_m.wall`) — the same composition contract as
  # `examples/museum-wings.arch`. No door is drawn INSIDE the component on purpose: which
  # bedroom it opens into is the parent's decision, exactly like the wing's hall door.
  component ensuite() {
    wall id=wall partition thickness 100 { (0,0) (1800,0) (1800,2600) (0,2600) close }
    room id=room at (0,0) size 1800x2600 label "Ensuite" uses bath
    # `inset 150`, not `flush`, on the two NORTH fixtures: every placement backs that edge
    # onto a THICKER host wall (`shell` 300 mm for en2, `w_l2_band` 200 mm for the suites)
    # running along the same line as this component's own 100 mm wall — `flush` reads the
    # nearer face and collides with the far one. The shower goes top-RIGHT: each suite's
    # bedroom door lands on the LEFT edge (`at 7500` below), and a shower there
    # would leave it no swing room. The WC sits below it on the EAST wall, 100 mm off (en_m's
    # shell is thicker).
    furniture shower in room anchor top-right   inset 150 size 900x900
    furniture basin  in room anchor top-left    inset 150 size 600x500
    furniture wc     at (room.right - 900, room.top + 1400) size 700x400 rotate 90 in room
  }

  # =====================================================================================
  # LEVEL 1 — entry level: garage, study, living/dining/kitchen, terrace
  # =====================================================================================
  level 1 "Ground floor" {
    # ---- shell ------------------------------------------------------------------------
    # One closed ring for the main volume, with a bowed bay let into the south (garden)
    # wall behind the living room — a curved arc EDGE, not a separate `room circle`,
    # walked from (4400,10200) to (1600,10200) with `cw` so it bulges OUTWARD.
    wall id=shell exterior thickness 300 {
      (0,0) (13800,0)
      (13800,10200)
      (4400,10200)
      arc (1600,10200) radius 2000 cw
      (0,10200)
      close
    }

    # The garage/utility wing: three sides only (its fourth side is the main shell's own
    # west face, so nothing is drawn twice).
    wall id=w_wing_n exterior  thickness 300 { (-5500,0) (0,0) }
    wall id=w_wing_w exterior  thickness 300 { (-5500,0) (-5500,10200) }
    wall id=w_wing_s exterior  thickness 300 { (-5500,10200) (0,10200) }
    wall id=w_util   partition thickness 200 { (-5500,6200) (0,6200) }

    # Front-band partitions (street side).
    wall id=w_office_e   partition thickness 100 { (4000,0) (4000,4200) }
    wall id=w_powder_w   partition thickness 100 { (8000,0) (8000,2200) }
    wall id=w_powder_e   partition thickness 100 { (10000,0) (10000,2200) }
    wall id=w_frontsvc_s partition thickness 100 { (8000,2200) (13800,2200) }
    wall id=w_entry_svc  partition thickness 100 { (8000,2200) (8000,4200) }

    # Front/back band spine, and the garden-band partitions.
    wall id=w_l1_band_w partition thickness 200 { (0,4200) (8000,4200) }
    wall id=w_l1_band_e partition thickness 200 { (8000,4200) (13800,4200) }
    wall id=w_liv_din   partition thickness 200 { (4800,4200) (4800,10200) }
    wall id=w_din_kit   partition thickness 100 { (8000,4200) (8000,8200) }
    wall id=w_din_terr  partition thickness 200 { (8000,8200) (8000,10200) }
    wall id=w_kit_terr  exterior  thickness 200 { (8000,8200) (13800,8200) }

    # ---- rooms, grouped into wings by `zone` -------------------------------------------
    zone service "Service wing" {
      room id=r_garage  at (-5500,0)    size 5500x6200 label "Garage"  uses garage
      room id=r_utility at (-5500,6200) size 5500x4000 label "Utility" uses utility
      room id=r_powder  at (8000,0)     size 2000x2200 label "Powder"  uses wc
      room id=r_pantry  at (10000,0)    size 3800x2200 label "Pantry"  uses storage
    }

    zone living "Living wing" {
      # The study: a rectangle with its SE corner chamfered into a reading nook, an
      # ANGLED room via `room polygon` — an exact shoelace area, label at the centroid.
      room id=r_office polygon
        (0,0) (4000,0) (4000,3400) (3200,4200) (0,4200)
        label "Study" uses office
      room id=r_entry   at (4000,0)    size 4000x4200 label "Entry"          uses entry hall
      room id=r_living  at (0,4200)    size 4800x6000 label "Living"         uses living
      room id=r_dining  at (4800,4200) size 3200x6000 label "Dining"         uses dining
      room id=r_kitchen at (8000,4200) size 5800x4000 label "Kitchen"        uses kitchen
      room id=r_terrace at (8000,8200) size 5800x2000 label "Terrace"
      # Behind Powder/Pantry, reached from Entry via `o_entry_svc`: their doors need a room
      # on the other side (a door onto room-less floor never enters the access graph).
      room id=r_service at (8000,2200) size 5800x2000 label "Service Hall" uses hall circulation
    }

    # ---- doors: one kind per situation -------------------------------------------------
    door id=d_front         at (6000,0) width 1200 wall shell hinge left swing into r_entry
    door id=d_office        at (4000,2000) width 900 wall w_office_e hinge left swing into r_office
    # Two cars, so a double-width sectional door (4800, two bays of 2400) and a drive as
    # wide as the garage out to the street.
    door id=d_garage        garage at (-2700,0) width 4800 wall w_wing_n
    door id=d_garage_int    at (0,7600) width 900 wall shell swing into r_utility
    door id=d_garage_util   bifold on w_util at 2750 width 1500 swing in
    door id=d_utility_ext   at (-2700,10200) width 900 wall w_wing_s hinge right swing out
    door id=d_powder        pocket on w_frontsvc_s at 1000 width 800 slide right
    door id=d_pantry        barn on w_frontsvc_s at 3900 width 900 swing in
    door id=d_kit_corr      on w_l1_band_e at 2900 width 1200 hinge right swing into r_kitchen
    door id=d_din_kit       on w_din_kit at 2000 width 1000 swing into r_kitchen
    door id=d_din_terrace   at (8000,9200) width 900 wall w_din_terr hinge left swing into r_terrace
    door id=d_kit_terrace   sliding on w_kit_terr at 3000 width 2400 slide left
    door id=d_living_garden at (800,10200) width 1000 wall shell hinge left swing out

    opening id=o_liv_din on w_liv_din at 2000 width 3000
    opening id=o_entry_svc on w_entry_svc at 1000 width 1600
    opening id=o_entry_dining on w_l1_band_w at 6200 width 2400

    # ---- windows: the ribbon of study windows is a `for` loop --------------------------
    for i in 0..3 {
      window on shell at (700 + i * 1100) width 700
    }
    window on shell at 11800 width 900                # pantry
    window on shell at 19000 width 1200                # kitchen (east wall)
    window on shell at 20400 width 1000                # kitchen (east wall)
    window on shell at 23000 width 1400                # terrace (east wall)
    window on shell at 17000 width 900                 # corridor (east wall)
    window at (6000,10200) width 1800 wall shell        # dining, south wall
    window on shell at 34950 width 1500

    # ---- furniture ----------------------------------------------------------------------
    furniture desk         at (600,2700)  size 1600x700 in r_office
    furniture office_chair at (2300,2900) size 600x600  rotate 90 in r_office
    furniture bookshelf    at (200,3700)  size 1600x300 in r_office

    furniture rug          at (600,5100)  size 3000x2300 in r_living
    furniture sofa_l        at (700,5600)  size 2400x1500 in r_living
    furniture coffee_table  at (1300,7200) size 1000x500  in r_living
    furniture armchair      at (3200,5750) size 900x900  rotate 270 in r_living
    furniture plant         at (300,4400)  size 600x600  in r_living
    furniture piano          at (3000,8700) size 1600x1200 rotate 270 in r_living
    furniture tv_unit against wall w_liv_din offset 3000 size 1500x500 in r_living

    furniture dining_table at (5600,6800) size 2000x1000 in r_dining

    furniture counter        against wall shell segment 1 offset 4900 size 1000x600 in r_kitchen
    furniture kitchen_sink   against wall shell segment 1 offset 5800 in r_kitchen
    furniture stove          against wall shell segment 1 offset 7400 in r_kitchen
    furniture dishwasher     against wall shell segment 1 offset 6600 in r_kitchen
    furniture fridge         against wall w_l1_band_e offset 4700 size 600x700 in r_kitchen
    furniture upper_cabinet  against wall w_l1_band_e offset 4500 size 600x400 in r_kitchen
    furniture island         at (9200,5400) size 1800x900 in r_kitchen
    furniture barstool       at (8900,6500) size 400x400  in r_kitchen
    furniture barstool       at (9500,6500) size 400x400  in r_kitchen
    furniture barstool       at (10100,6500) size 400x400 in r_kitchen

    furniture washer against wall w_wing_w offset 6800 in r_utility
    furniture dryer  against wall w_wing_w offset 7400 in r_utility

    furniture wc    against r_powder.left offset 1000 size 400x700
    furniture basin in r_powder anchor top-right   flush size 600x500

    outdoor id=g_drive driveway at (-5500,-3000) size 5500x3000 label "Drive"

    furniture car at (-4800,700) size 1800x4600 in r_garage
    furniture car at (-2300,700) size 1800x4600 in r_garage

    furniture sun_lounger at (9000,8700)  size 1900x700 in r_terrace
    furniture sun_lounger at (11200,8700) size 1900x700 in r_terrace

    dim (8000,10500)->(13800,10500) offset 600 text "Terrace 5.8 x 2.0 m"
    dim (0,10800)->(3000,10800) offset 300

    stair id=stair at (1000,4300) size 2900x800 dir up
  }

  # =====================================================================================
  # LEVEL 2 — sleeping level: the master suite and a second suite on the garden side, a
  # study and a studio on the street side, and a gallery over the double-height living room
  # =====================================================================================
  level 2 "Upper floor" {
    # ---- shell --------------------------------------------------------------------------
    # No garage below this footprint and no bay above it: a plain closed rectangle, so its
    # `roof overhang` below is a simple mitred offset with nothing curved to refuse.
    wall id=shell exterior thickness 300 { (0,0) (13800,0) (13800,10200) (0,10200) close }

    # ---- partitions -----------------------------------------------------------------------
    wall id=w_study_s partition thickness 100 { (0,2600) (4000,2600) }
    wall id=w_linen_s partition thickness 100 { (5800,2600) (8000,2600) }
    wall id=w_linen_e partition thickness 100 { (8000,0) (8000,2600) }
    wall id=w_studio_s  partition thickness 100 { (8000,2600) (13800,2600) }
    wall id=w_l2_band partition thickness 200 { (0,4200) (13800,4200) }
    wall id=w_gallery_e partition thickness 200 { (4800,4200) (4800,10200) }
    wall id=w_suites  partition thickness 100 { (8000,6800) (8000,10200) }
    wall id=w_dress_s partition thickness 100 { (11600,6800) (13800,6800) }

    zone sleeping "Sleeping wing" {
      room id=r_study  at (0,0)    size 4000x2600 label "Study"    uses office
      room id=r_linen  at (5800,0) size 2200x2600 label "Linen"    uses storage
      room id=r_studio at (8000,0) size 5800x2600 label "Studio"   uses office
      place ensuite() as en2 at (4000,0)

      # Both bedrooms take the garden (south) facade, each with its own ensuite, and the two
      # ensuites stand back to back on one wet wall: `en_b2` as authored, `en_m` its
      # `mirror x` twin. The master suite is bedroom, dressing room and ensuite: the
      # dressing room off the landing leads to the other two.
      room id=r_bed2 at (4800,4200) size 3200x6000 label "Bedroom 2" uses bedroom
      place ensuite() as en_b2 at (8000,4200)
      room id=r_dress  at (11600,4200) size 2200x2600 label "Dressing" uses storage
      room id=r_master at (8000,6800)  size 5800x3400 label "Master Suite" uses bedroom
      place ensuite() as en_m at (11600,4200) mirror x
    }

    room id=r_landing at (0,2600) size 13800x1600 label "Landing" uses hall circulation

    # The gallery: it contains the void over the living room below, so it keeps its own
    # full floor area even though a 3.0 x 4.2 m hole obstructs the middle of it.
    room id=r_gallery at (0,4200) size 4800x6000 label "Gallery" uses hall circulation

    # ---- doors ----------------------------------------------------------------------------
    door id=d_study  on w_study_s at 3200 width 900 swing into r_study
    door id=d_studio   on w_studio_s  at 1000 width 900 swing into r_studio
    door id=d_linen  on w_linen_s at 1100 width 800 swing out
    door id=d_bed2   on w_l2_band at 6400 width 900 swing into r_bed2
    door id=d_dress  on w_l2_band at 12700 width 900 swing into r_dress
    door id=d_master on w_dress_s at 1100 width 900 swing into r_master
    # `en2` is the family bathroom: its one door is on the landing (its south wall,
    # run-length 5300), so no room is a way through it. Pocket, not hinged, into bedroom 2:
    # a bed, a wardrobe and this doorway compete for the same wall.
    door id=d_en2_corr on en2.wall at 5300 width 800 swing out
    door id=d_enb2     pocket on en_b2.wall at 7500 width 800 slide right
    door id=d_enm      on en_m.wall at 7500 width 800 swing into r_dress
    opening id=o_gallery on w_l2_band at 1050 width 1600

    # ---- windows ----------------------------------------------------------------------------
    window on shell at 1200  width 1400               # study, north wall
    window on shell at 11600 width 1400               # studio, north wall
    window at (6400,10200)  width 1800 wall shell     # bedroom 2, south wall
    window at (9800,10200)  width 1800 wall shell     # master suite, south wall
    window at (12000,10200) width 1600 wall shell     # master suite, south wall
    window at (13800,5500)  width 1200 wall shell     # dressing room, east wall
    window at (0,7000)      width 1400 wall shell     # gallery, west wall

    # ---- furniture --------------------------------------------------------------------------
    furniture id=f_sdesk desk against wall shell segment 0 offset 1200 size 1400x700 in r_study
    furniture office_chair at (900,900) size 600x600 facing f_sdesk in r_study
    furniture bookshelf against wall shell segment 3 offset 8700 size 1600x300 in r_study

    furniture sofa      against wall shell segment 0 offset 11600 size 2000x900 in r_studio
    furniture desk      against wall w_studio_s offset 2500 size 1400x700 in r_studio
    furniture bookshelf against wall w_studio_s offset 4500 size 1600x300 in r_studio

    # Each bed's head is on the suites' shared partition or the east shell, never under a
    # window.
    furniture bed        against wall w_suites offset 1700 size 1500x2000 in r_bed2
    furniture nightstand against wall w_suites offset 700  size 500x400 in r_bed2
    furniture wardrobe   against wall w_gallery_e offset 2000 size 1800x600 in r_bed2

    furniture double_bed against wall w_suites offset 1700 size 1800x2000 in r_master
    furniture nightstand against wall w_suites offset 550  size 500x400 in r_master
    furniture nightstand against wall w_suites offset 2850 size 500x400 in r_master
    furniture wardrobe   against wall shell segment 1 offset 9100 size 1800x600 in r_master
    furniture armchair   at (11000,9000) size 900x900 in r_master

    # The gallery railing looks down into the double-height living room below — a `void`
    # does not reduce this room's own area (`describe --json` reports it under `voids[]`).
    void id=v_gallery at (900,5100) size 3000x4200

    # The eaves: derived from THIS storey's own closed shell, mitred outward — it draws
    # and nothing else, but it does grow the page.
    roof overhang 700 wall shell

    stair id=stair at (1000,4300) size 2900x800 dir down
  }

  axes {
    x at 0, 4000, 8000, 10000, 13800
    y at 0, 2600, 4200, 10200
  }

  title {
    project "Hillside Villa"
    drawn_by "ArchLang"
    date "2026-08-27"
  }
}

Read more