# Wallgraph

> A free, browser-based floorplan editor that is exact to the millimetre. It stores a plan as a
> planar graph of wall centerlines in integer millimetres and derives everything visible — wall
> faces, mitred corners, rooms, areas — from that graph. Runs entirely in the browser: no account,
> no server, no runtime dependencies. Interface in Dutch and English; drawing conventions follow
> the Dutch NEN plan sheets.

Live at https://plattegrond.crocode.nl/ · Source at https://github.com/irongollem/wallgraph · AGPL-3.0-only. Commercial licences are available
from the copyright holder: info@crocode.nl.

## What it does

- Draw walls by typing exact lengths in whole millimetres
- Rectangle, circle and polygon in two clicks, with shared walls merged
- Doors, windows and passages that cut the wall automatically
- 27 NEN door and window types with turn, tilt, slide and tumble direction
- 82 plan symbols: electrical, water, sanitary, heating, ventilation, fire safety, kitchen, furniture
- 15 stair types, each sized for its own plan: straight, landing, quarter-turn, spiral, helical
- Automatic room detection with net floor area per NEN 2580
- Multiple storeys with the one below as a tracing underlay
- Export to PNG, SVG and DXF at true scale
- Works offline, saves locally, no account required

## Agent access

Wallgraph provides two client-side automation channels. Neither requires an account or API key:

- **A plan in a URL.** Put the document's JSON in a base64url string after `#plan=`:
  `https://plattegrond.crocode.nl/#plan=<base64url>`. Add `&lang=en` to set the interface language. The fragment
  never reaches the server. Loading the plan creates an undoable document step.
- **`window.wallgraph` on the hosted page.** `load(doc)`, `save()`, `link()`,
  `language(code)`, plus `version` and `schema`. These methods can be called through
  `page.evaluate`.

The editor is a canvas application. Its drawing surface is not exposed as interactive DOM elements;
automation must use the document channels described above.

## Limitations and responsibility

- Sections 15 and 16 of the AGPL-3.0 contain a disclaimer of warranty and a limitation of liability,
  subject to applicable law.
- Wallgraph calculates from user-supplied dimensions. It does not measure buildings or verify
  accuracy, completeness, regulatory compliance or suitability for a particular purpose.
- Area calculations are derived from the drawing. Wallgraph does not issue a certified NEN 2580
  measurement report.
- Wallgraph does not perform structural, fire-safety or services-design assessments. Work requiring
  professional verification must be reviewed by an appropriately qualified person.
- The user is responsible for the drawing, its verification and its use.

Full disclaimer:
https://plattegrond.crocode.nl/en/disclaimer/

## Documentation

- [Disclaimer](https://plattegrond.crocode.nl/en/disclaimer/): warranty, liability, verification and data handling.
- [Document format and agent API](https://plattegrond.crocode.nl/en/format/): the JSON model, the two agent channels, and their limits.
- [JSON Schema](https://plattegrond.crocode.nl/wallgraph.schema.json): draft 2020-12, every field described, unknown fields rejected.
- [Floorplan symbols](https://plattegrond.crocode.nl/en/symbols/): all 82 plan symbols with their type ids and millimetre dimensions.
- [Door and window types](https://plattegrond.crocode.nl/en/openings/): all 27 NEN opening types and how each is drawn in plan.
- [Manual](https://plattegrond.crocode.nl/en/manual/): tools, snapping, exports and every keyboard shortcut.

## In Dutch

- [Handleiding](https://plattegrond.crocode.nl/handleiding/)
- [Plattegrondsymbolen](https://plattegrond.crocode.nl/symbolen/)
- [Deur- en raamtypen](https://plattegrond.crocode.nl/kozijnen/)
- [Documentformaat en agent-API](https://plattegrond.crocode.nl/formaat/)
- [Disclaimer](https://plattegrond.crocode.nl/disclaimer/)

## Optional

- [Source repository](https://github.com/irongollem/wallgraph): TypeScript, zero runtime dependencies. `npm run build` produces a
  self-contained `dist/index.html` that works offline.
- [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html): permits use, modification and self-hosting subject to its terms. Running
  a modified version as a network service requires an offer of the corresponding source to its users.
  Commercial terms for uses that do not fit the AGPL are available from the copyright holder at
  info@crocode.nl.