Skip to content

File Format

André Borchert edited this page Aug 13, 2026 · 3 revisions

File Format

A room is a versioned UTF-8 JSON document. The web app stores rooms in SQLite, but the JSON envelope is what moves between the client and the server (and is the format a local file import uses).

{
  "format": "com.maria.roomcad-v2.room",
  "version": 1,
  "room": {
    "id": "…",
    "name": "…",
    "width": 4.87,
    "length": 16.44,
    "height": 3.6,
    "grid": "fiveCentimeters",
    "walls":  [ { "id": "…", "start": { "x": 0, "z": 0 }, "end": { "x": 4.87, "z": 0 } } ],
    "doors":  [ { "id": "…", "wallID": "…", "offset": 0.4, "width": 0.9, "open": true, "swingInside": true } ],
    "windows":[ { "id": "…", "wallID": "…", "offset": 0.08, "width": 0.72 } ],
    "furniture": [ { "id": "…", "kind": "bed", "center": { "x": 1.05, "z": 0.5 }, "rotationDegrees": 90 } ]
  }
}
  • Coordinates are metres; x is east/west and z is north/south (the top of the 2D plan is north).
  • grid is one of oneCentimeter, twoCentimeters, fiveCentimeters.
  • kind is one of bed, table, chair, wardrobe, light (a ceiling fixture, category fixture).
  • Unknown future versions and malformed data are rejected on load.

Clone this wiki locally