Home

RoomCAD wiki

RoomCAD is live — use it here: https://roomcad.91.99.176.243.nip.io/ Enter the shared password and you are in. Nothing to install.

It is a browser-based room planner: draw walls on a centimetre-accurate 2D plan, add doors, windows, furniture and lights, then walk through the result in 3D with real physics and daylight. Rooms are saved on a server, every save is a new version, and several people can edit the same design at once.

Try it in sixty seconds

#	Do this	What you get
1	Open the site, enter the password	a plan with an empty 2D grid
2	Toolbar → ＋ New Room, then set Width 400 and Length 300 in the inspector	a 4 × 3 m room
3	Press W, click a wall, drag to the far corner	a second wall, snapped to the first
4	Press G, click a wall	a window in it
5	Press ⌘2	you are standing in the room in 3D
6	Press L	lights on — and the street lamps outside come on too

⌘Z undoes anything. Nothing is saved until you press 💾 Save. Getting Started turns this into a full worked example.

Using RoomCAD

Page	Read it when you want to
Getting Started	build, save and version your first room — one worked example, step by step
2D Editor Guide	know every tool, snap, handle and shortcut
3D Walkthrough	walk the room, set the time of day, switch the lights
Live Collaboration	edit the same design with someone else
Troubleshooting	fix something that is behaving oddly

Running and integrating

Page	Read it when you want to
Hosting and Deployment	deploy it, or rebuild the server from nothing
Server API and Storage	call the API from something else, or understand the database
File Format	read, write or generate .rcad files

Working on the code

Page	Read it when you want to
Architecture and Development	run it locally, run the tests, and find where the rules live
Project Tracker	see what is open, what is deliberately not changing, and what is easy to get wrong twice

Run it locally

git clone https://github.com/Pummelchen/RoomCAD.git && cd RoomCAD
ROOMCAD_DB_PATH=/tmp/roomcad.db ROOMCAD_PASSWORD=letmein \
  python3 roomcad/server/server.py &   # the API on 127.0.0.1:8078
cd roomcad/web && ./serve.sh           # the app on http://localhost:8080

Open http://localhost:8080 and log in with letmein. There is no build step and no dependency to install: the app is plain ES modules, served straight from the working copy.