Documentation menu
DreamCode

Overview & IDE

Type your house: the DreamCode editor, building, files and pop-out window.

DreamCode is a tiny language for describing a house as rooms. You never draw walls: the compiler derives them from the rooms, merges walls that two rooms share, adds connecting doors, floors, ceilings, slabs, the roof, the staircase opening and the complete wiring — and the editor builds it all as normal parametric objects.

house.dream
room Living 6x5
door south
lights 2
room Kitchen 4x5 right of Living
window east
light

Open the editor#

In the 3D editor choose DreamCode → Open code editor. The code opens on the left in a VS Code-style editor; the 3D view stays live on the right.

ControlWhat it does
▶ BuildCompile and draw the house. Shortcut ⌘ S / Ctrl S.
Examples…Replace the code with a one-storey or two-storey example.
{ }Show the JSON the compiler produces from your code.
?One-screen language cheat sheet.
📂 Open · 💾 Save asLink the editor to a .dream file on your disk (Chrome / Edge).
💬 ChatShow or hide the DreamCode AI chat.
🤖 ConnectLet Claude Code drive the editor.
⧉ Pop outMove the editor into its own window so the 3D view gets the whole screen. ⇤ Dock brings it back.

How building works#

  • Typing only checks the code: problems appear in the PROBLEMS pane and the offending lines turn red. Click a problem to jump to its line.
  • Building replaces the previous DreamCode house in one undoable step. Anything you placed by hand is left alone.
  • The first build frames the camera on the new house; later builds keep your view.
  • Your code is kept in the browser, so it’s still there after a reload.
Reopening a saved plan
A saved plan stores the built house, not the DreamCode text, and the rebuilt objects are no longer marked as DreamCode’s. Building again in a reopened plan adds a new house next to the old one — use File → Clear workspace first, or keep the .dream file as your source of truth.

Work with files and other editors#

  1. Link a file

    Click 💾 Save as (new file) or 📂 Open (existing). The tab shows the file name.

  2. Edit anywhere

    Change the file in VS Code, Vim or with an AI agent. Within a second the editor reloads it and rebuilds the house.

  3. Saves go both ways

    Every build in DreamHome writes the code back to the file. If the file changes on disk while you have unsaved edits, you’re asked before anything is replaced.

Note
File linking uses the browser’s File System Access API (Chrome and Edge). Browsers don’t keep the permission across reloads — click 📂 Open again after reloading.