planimity

OpenPlan3D user guide

This guide describes the hosted editor at https://app.openplan3d.com as of October 2026. Menu, button and tool names are written exactly as they appear in the English interface (Settings → Appearance → Language switches the interface to Português). Shortcuts are written with Ctrl; on a Mac, Cmd works the same way.

Contents

  1. Getting started
  2. Drawing walls
  3. Rooms
  4. Doors and windows
  5. Floors
  6. Furniture and custom 3D models
  7. Dimensions and annotations
  8. 3D view and walkthrough
  9. Settings
  10. Saving and the project library
  11. Exporting and downloads
  12. Importing
  13. iPhone app handoff
  14. Sharing with an assistant
  15. Keyboard shortcuts
  16. Troubleshooting
  17. Getting help

1. Getting started

The project library

Opening https://app.openplan3d.com shows the Floor Plan Editor library: one card per project with a preview, its name and when it was last changed. There is no account and nothing is uploaded; as the page says, “Projects and version history are saved in this browser.” (See section 10 for what that means.)

First visit

With no projects yet, a Welcome screen offers Start from Scratch, Use a Template, Import a Plan (“Load a JSON or RoomPlan file”; this button accepts .json files only) and a four-step Quick Tour. Links at the bottom let you Restore a library backup or Import a project package instead. Both kinds of JSON backup load from here. Import a Plan opens a project from Download JSON in the editor, and hands a file from Download library backup to Restore library backup, which lists its projects before adding them as copies. Restore a library backup also takes a project from Download JSON and adds it as a copy.

The editor at a glance

Short one-time tips appear the first time you draw a wall, place a door or furniture, open 3D or export (“Got it” dismisses them).

2. Drawing walls

  1. Press W or choose Build → Draw Wall (“Click to draw, dbl-click to finish”).
  2. Click where the wall starts. Move the mouse; the length and angle are shown next to the wall.
  3. Each further click places a corner and starts the next wall.
  4. To finish: double-click, press Escape, or close the loop. Clicking near the first point closes the loop automatically; pressing C closes it from wherever you are.

Useful while drawing:

Editing walls

Press V (Select) and click a wall. The Wall Properties panel shows:

On the canvas, with a wall selected:

Elevation view

The Plan / Elevation switch in the top bar shows one wall face-on. With a wall selected, Elevation opens that wall; otherwise it asks you to “Click a wall to view its elevation — Esc to cancel”. In the elevation you can “Drag openings to move · drag windows up/down for sill · Esc for plan”, and step through walls with Previous wall / Next wall.

3. Rooms

Rooms are detected automatically wherever walls form a closed loop; the status bar count updates as you draw. A room gets a label with its name and area.

Area Summary (top bar) lists Interior area (“Interior area excludes wall footprints. The totals and room breakdown below use wall centerlines.”), Rooms, Total Area, Doors / Windows, Wall Length, totals By Category and a Room Breakdown with percentages. Areas follow the unit chosen in Settings. If you see “No rooms detected yet. Draw walls to create rooms.”, a loop is not closed; check the corners.

Ready-made shapes live in the Rooms tab: Room Presets (Rectangle, L-Shape, T-Shape, U-Shape — “Click to add a room shape to the canvas”) and Room Templates (Living Room, Bedroom, Kitchen, Bathroom, Office, Dining Room — “Pre-furnished rooms — walls + furniture in one click”). Click one to place it at the centre of the view, or drag it onto the canvas.

4. Doors and windows

The bottom of the Build tab lists Doors (Single 90cm swing, Double 150cm swing, Sliding 180cm slide, French 150cm glass, Pocket 90cm recess, Bifold 180cm fold, Doorway 100cm open, Garage 240cm overhead) and Windows (Standard 120×120cm, Fixed 100×100cm, Casement 80×130cm, Sliding 180×120cm, Bay 200×150cm).

5. Floors

6. Furniture and custom 3D models

The catalog

Objects tab. Use Search furniture…, the All / ♥ Favorites / category chips (Living Room, Bedroom, Kitchen, Bathroom, Office, Dining, Decor, Lighting, Outdoor Furniture, Landscaping, Fencing, Structures, Pool & Spa, Garage, Paths & Lawns, Outdoor Lighting, Garden Structures, Electrical, Plumbing, Imported) and the Recent row. Hovering an item shows its size (width × depth × height in cm). The ♥ on a card adds it to Favorites.

Placing and editing

Selecting several things

Stairs and columns

Build → Add Stairs (“Click to place stairs”), then set Stair Properties: Straight, L-Shaped, U-Shaped or Spiral, Risers, and Direction (Up ↑ / Down ↓). Round Column / Square Column place columns; Column Properties has Shape, Diameter or Side Length, and colours.

Entourage (2D symbols)

At the bottom of the Objects tab, Entourage holds flat symbols for plans: People, Vehicles, Planting and Outdoor. Click one, then click the canvas to place it (“Shift-click to stamp several”). + Upload symbol (PNG, JPEG, WebP) adds your own image (up to 2 MB); it appears under Custom. Symbols have Rotation, Opacity and a lock; they show in 2D and in 2D exports.

My 3D models (your own GLB files)

At the top of the Objects tab, My 3D models → Import GLB model (“Static GLB files up to 16 MiB. Files stay in this project.”):

  1. Choose a .glb file. A preview shows its size as “Width … × depth … × height … cm” (glTF metres become centimetres).
  2. Enter a Model name and optionally Attribution, License and a Source URL, then Add to project.
  3. Use Place at view center on the saved model to put a copy on the current floor; move and resize it like any furniture. Save the project to keep it.
  4. Remove model deletes the definition once no placed copies remain (“Remove this model’s placed furniture before removing its definition.”).

Only static glTF 2.0 binaries with embedded textures are accepted (no external files, animations, skins or cameras); a project can hold up to 64 models. The model bytes are stored inside the project, so they travel with JSON, library backups and project packages. See Local custom furniture models for the full limits.

Item details and photos

Below the properties of a wall, room, door, window or furniture item, Item details stores Item notes, Item cost, Construction material, Room use, Room ceiling height and Item photos (Add photo: “JPG or PNG, up to 8 MiB and 24 megapixels. Large photos become resized copies up to 1600 pixels. No uploads.”). These travel in project packages to the iPhone app and to assistant shares. Retained attachments lists files kept from an imported package; Delete file… removes one from future exports.

7. Dimensions and annotations

Automatic dimensions

Settings → Dimensions turns automatic wall dimensions on or off (Dimensions), and separately External Dimensions, Internal Dimensions, Extension Lines, Object Distance (distances from furniture to walls) and the Line Color (white or dark). Measure walls chooses Centerline or Edge to edge (“Edge to edge shows the clear span between adjoining wall faces”); the PNG, SVG, DXF and PDF exports print wall lengths the same way, and a curved wall always shows its centreline length. In the status bar’s Layers popover, Automatic dimensions is the same switch as Settings → Dimensions → Dimensions, and Room Labels hides room names and areas until you turn it back on. The exports follow these switches: with automatic dimensions or External Dimensions off, the PNG, SVG, DXF and PDF exports leave the wall lengths out (see section 11).

Dimension tool (N)

Build → Dimension (“Add dimension annotations (N)”). Click two points; a box asks for a Dimension label (optional) — “Leave empty for measured distance” — and Enter confirms. Dimensions appear in exports.

Measure tool (M)

Build → Measure (“Measure distances (M)”). Click two points to leave a measurement line with its distance. Select and press Delete to remove it.

Text labels (T)

Build → Text Label (“Add text annotations (T)”). Click where the note goes, type, and press Enter (Escape cancels). Double-click a note to edit it; the Text Annotation panel sets Text and Font Size.

Guides, rulers, grid and map

Layers panel

L (or the 🗂 button) opens Layers: every element on the floor grouped as Walls, Doors, Windows, Furniture, Entourage, Stairs, Columns, Guides, Measurements, Annotations, Text notes and Rooms. Each group can be hidden or shown, and clicking an entry selects it on the canvas — useful for small or overlapping items. A hidden group is also left out of Print Layout and the 2D exports (see section 11).

8. 3D view and walkthrough

Press Tab or click 3D in the top bar (“Loading 3D viewer…” appears the first time while the viewer downloads). Drag to orbit, scroll or pinch to zoom, right-drag (two fingers on touch) to pan, double-click a point to orbit around it. Switching floors in 3D rebuilds the scene for that floor.

The toolbar at the top right has:

Lighting Controls (bottom left) has Time of Day presets (morning, noon, evening, night), Sun Position, Sun Elevation and Ambient Light. Export Blender Scene downloads openplan3d-render-scene.json for the separate local render lab described in render-lab.md; it is not needed for normal use.

Room floors come from Floor Material in 2D Room Properties; wall colours and textures from Wall Properties. The 3D view needs WebGL; if the browser cannot start it, the view says “The 3D view needs WebGL, which this browser could not start. …” instead. Check that hardware acceleration is enabled in the browser and that no extension blocks WebGL; the 2D plan keeps working.

9. Settings

The Settings dialog (gear icon in the top bar, or Settings in the More menu) has four tabs:

Changing the unit converts the display everywhere (lengths, areas, the wall length field, exports). Imperial lengths are shown in feet and inches; the wall Length field accepts values such as 5'6", 12" or 2.5 m.

10. Saving and the project library

Autosave

Every change is saved to the browser about one second after you stop editing. The top bar shows Unsaved •, Saving…, then Saved ✓; hovering the status shows “Last saved: …”. Save (or Ctrl+S) saves immediately. The editor also saves when you switch tabs, go back to Projects or close the window.

Where projects live, and what happens if browser storage is cleared

Projects, thumbnails and version history are stored in this browser’s site storage (IndexedDB) for app.openplan3d.com. Nothing is sent to a server, which also means:

Persistent storage

Browsers keep site data either as best-effort storage, which they may delete on their own to free space (Safari can also delete the data of sites you have not used for a while), or as persistent storage, which only you can delete. The first time you save work in a browser (creating, saving, copying, restoring or importing a project), OpenPlan3D asks once to keep the library in persistent storage. Opening a page never asks, and saving never waits for the answer.

Persistent storage only stops automatic cleanup. Clearing site data, a “delete on close” setting, a private window or another browser profile still removes or hides the library, so backups stay the copy you control. While the browser has not agreed to keep the library, the library page says so and recommends Download library backup (see section 1).

Version History

Version History (clock icon in the top bar) keeps up to 10 snapshots per project: one at “Session start”, an “Auto-save” every 5 minutes while the plan has changed since the last snapshot (“Versions are saved automatically every 5 minutes.”), a “Manual save” when you press Ctrl+S, and a “Before restore” copy of the version you are replacing whenever you restore one. Restore loads a snapshot (“Restore this version? The current version is kept in Version History.”), and Clear all versions deletes them. If the history cannot be read, the dialog offers Download version backup (openplan3d-version-history-backup.json).

Version history is separate from Undo / Redo (Ctrl+Z / Ctrl+Y), which keeps up to 50 steps for the current session; the Undo History panel lists them by name (“Added wall”, “Moved furniture”, …).

Library backups

On the library page, Download library backup saves openplan3d-library-backup.json with every project, its version history, previews and any recovery data. Restore library backup (“Add restored copies to this browser. Your existing projects stay available.”) reads such a file, lists what it contains (“New copy · 3 saved versions”), and Restore as copies adds them without overwriting anything. At most the latest 10 valid versions per project are restored; damaged entries are kept as recovery data and included in future backups.

Restore library backup also takes a single project saved with Download JSON (or Download JSON backup in the red save bar), for example Our house.json or a second download named Our house(1).json. That is the quickest way back if browser storage was cleared: choose the file, check that the preview lists the project, and choose Restore as copies; it comes back as “Our house (Restored copy)”.

Save problems

If a save fails, a red bar reads “Changes are not saved.” followed by the reason, with Retry save and Download JSON backup. When the project was changed in another tab (“This project changed or was deleted in another tab. Save your version as a copy or download a JSON backup to keep both versions.”) use Save as copy. See Troubleshooting for the storage messages.

When a new release is deployed you may see “An app update is ready. Reload to use the latest version. Your project will be saved first.” — choose Save and reload.

11. Exporting and downloads

The Export menu

The Export button in the top bar opens:

Menu item File you get What it contains
Print Layout (Ctrl+P) <project>-1-50.pdf (or -Fit to page.pdf), or the browser print dialog Active floor to a true scale on Letter or A4, with a room schedule page
Export 2D as PNG <project>.png Active floor as an image of what the 2D plan shows: room fills and labels, walls and their lengths, openings, furniture symbols, stairs, columns, measurements, dimensions and notes, with “ — " as a title; up to 2× resolution, at most 4096 px per side
Export 3D as PNG <project>-3d.png The 3D view of the active floor (the editor switches to 3D, renders, downloads, and returns to 2D)
Export as SVG <project>.svg Vector drawing of the active floor; 1 unit = 1 cm; opens in Inkscape, Illustrator, browsers
Export as DXF <project>.dxf CAD drawing of the active floor in centimetres with layers WALLS, DOORS, WINDOWS, FURNITURE, DIMENSIONS, ROOMS, STAIRS, COLUMNS
Export as DWG <project>.dxf There is no DWG writer. The editor downloads the DXF and shows the notice “DWG saved as DXF — DWG is a proprietary format, so a DXF file was downloaded instead. AutoCAD, SketchUp and FreeCAD open DXF directly.”
Export as PDF <project>.pdf A4 landscape sheet of the active floor with a title block, Room Schedule pages and, if the 3D view is open, a 3D Perspective View page; the sheet’s labels follow the interface language
Download JSON <project>.openplan.json The complete project: all floors, rooms, furniture, notes, settings stored in the project, background images and custom models. This is the file to keep as a backup and to reopen with Import JSON
Download project package openplan3d-project.zip “For iPhone and web. Includes retained original data and attachments, even when they are not shown here.” See below
Share with Assistant… nothing downloaded Uploads a copy for seven days and gives you a code and secret (section 14)
Other planners → Open in OpenLandscape3D, Open in OpenKitchen3D, Open in OpenCatio3D nothing downloaded; a new tab Opens that planner with the whole plan in the link (see “Opening a plan in another planner” below)
Download interchange JSON <Project-Name>-openplan3d.json “For OpenKitchen3D, OpenLandscape3D, OpenCatio3D and the iPhone app. Opening another planner puts the whole file in the link; nothing is uploaded. The file carries the plan’s geometry only; the project package keeps the full plan.” Walls, doors, windows, furniture and room labels in metres, plus anything one of those planners stored in the file
Import JSON — Opens a .json or RoomPlan .zip as a new project (section 12)
Import project package — Opens the same Import project package dialog as the library page (section 12); after Import as copy the editor switches to the imported copy
New Project — Saves the current plan and opens an empty one

<project> is the project name; an unnamed project exports as floorplan. Browsers add “ (1)”, “ (2)” and so on when a file with the same name already exists in the Downloads folder.

If the active floor is empty, the 2D PNG, SVG, DXF, DWG and PDF exports do nothing except show “Add walls, furniture, stairs, columns, entourage, notes or measurements to the active floor before exporting a PNG” (or “… an SVG”, “… a DXF”, “… a DWG”, “… a PDF”). If everything on it is on a hidden layer, they say “Everything on the active floor is on a hidden layer. …” instead (see What the 2D exports show).

DXF and DWG files hold CAD linework only, so they leave out uploaded entourage symbols and entourage at 0% opacity, which the SVG, PNG and PDF exports include. When those are all the active floor holds, Export as DXF and Export as DWG download nothing and say “A DXF can’t include uploaded entourage symbols or entourage at 0% opacity, and the active floor has nothing else to export. Export as SVG, PNG or PDF instead.” (or “A DWG …”).

Printing to scale (Print Layout)

Export → Print Layout (or Ctrl+P) opens Print Preview:

Export as PDF

Export as PDF is the presentation sheet: A4 landscape, a double border, a title block with the project name, floor name, description, date, units, “openplan3d.com” and “Created with OpenPlan3D”, then Room Schedule pages (#, Room Name, Type, Area, Floor Texture) and a 3D Perspective View page captured from the 3D view. These labels and the date follow the interface language (Portuguese: “Tabela de ambientes”, “Vista 3D em perspectiva”). The 3D page is only possible while the 3D view is open: switch to 3D, wait for it to render, then choose Export → Export as PDF. Exporting from 2D gives “PDF exported without the 3D view — The floor plan was exported. Reopen the 3D view and try again to include it.” It is not printed to a fixed scale; use Print Layout for that.

What the 2D exports show

Print Layout, Export 2D as PNG, Export as SVG, Export as DXF / DWG and Export as PDF draw the active floor the way the 2D plan shows it. Hide what you do not want on paper before exporting — for example, turn off automatic dimensions for an outline of the shell without estimated lengths. Everything that shows by default is exported by default.

On screen Left out of the exports while it is off
Settings → Dimensions → Dimensions, or Automatic dimensions in the status bar’s Layers popover (the same switch) Automatic wall lengths, and the room width × depth that Print Layout prints with Internal Dimensions on
Settings → Dimensions → External Dimensions Automatic wall lengths
Settings → Dimensions → Internal Dimensions (off by default) Room width × depth, which only Print Layout prints
A group in Layers (L), or its checkbox in the status bar’s Layers popover: Walls, Doors, Windows, Furniture, Entourage, Stairs, Columns, Measurements, Annotations (Dimensions in the popover: the Dimension tool’s lines), Text notes That group. Hidden walls take their lengths with them, but rooms stay filled because they are traced from the walls
Room Labels in the status bar’s Layers popover Room names and areas
Furniture in the status bar, Toggle Furniture in the top bar or Show Furniture in the More menu Furniture (the same switch as the Furniture group)

The grid, guides, rulers, mini-map, selection handles, the distances shown while a door, window or furniture item is selected, and the Floor Below ghost are never exported; Extension Lines, Object Distance and Line Color only change the screen. The PDF’s Room Schedule and summary always cover the whole floor. If every item on the active floor is hidden, the export says “Everything on the active floor is on a hidden layer. Exports show only what the 2D plan shows: turn the layers back on under Layers and export again.” instead of saving an empty file, and Print Preview says “Everything on this floor is on a hidden layer. Turn its layers back on under Layers to print it.” Export 3D as PNG shows the 3D view, which has no labels, notes or dimensions. JSON files, project packages and interchange files always contain everything.

3D images

JSON, project package or library backup?

Do not re-zip or edit a package with another tool; only packages written by OpenPlan3D are accepted (“Unsupported ZIP layout. Export a new project package from OpenPlan3D.”).

Opening a plan in another planner

OpenLandscape3D (https://openlandscape3d.com), OpenKitchen3D (https://openkitchen3d.com) and OpenCatio3D (https://opencatio3d.com) are free web planners from the same makers that read and write the same plan file. Under the Other planners caption of the Export menu:

The file carries walls, doors, windows, furniture, room names and colours and floor names, in metres. It does not carry stairs, columns, dimension or text notes, measurements, guides, entourage, background images, wall colours and textures, Item details, Open to floor below or floor elevations and slab thicknesses (a plan that comes back through the file has a slab in every room and floors 300 cm apart on 5 cm slabs). A curved wall travels as its straight chord, a sloping wall at its taller height, and door types other than single, double and sliding become the nearest of those. Anything a sibling planner stored in a file you imported (its cabinets, plants, areas or structures) is kept with your project and written back when you export, so a kitchen can go OpenKitchen3D → OpenPlan3D → OpenKitchen3D without losing its cabinets — as long as you keep working from this project, its Download JSON or a library backup, not from a project package. OpenKitchen3D and OpenLandscape3D also pick up walls, doors and windows you edited here. OpenCatio3D rebuilds its house from its own stored walls, so wall edits made here do not change the catio’s host walls yet; its design itself survives the round trip. A link sent to another planner leaves out precise site coordinates, observation positions and photo names; the downloaded file keeps them.

If opening fails you will see Couldn’t open the other planner with one of:

Where the file goes, and why a download may seem to do nothing

All exports are ordinary browser downloads started when you click a menu item; no file is written anywhere else.

12. Importing

Imports open a new project; the project you are working on is saved first and stays in the library. If the file’s internal ID clashes with an existing project, the copy is named “… (Imported copy)”. The one exception is Add to this plan in the Import RoomPlan dialog, which stitches a scan into the open project (below).

Import JSON (Export menu)

Export → Import JSON accepts:

RoomPlan files are converted to walls, doors, windows, rooms and furniture. Files that cannot be read show “Couldn’t import plan” with the reason, and “No project was imported.” — your current plan is untouched.

Import RoomPlan (Build tab)

Build → Import RoomPlan (“iOS LiDAR scan (.json/.zip); add scans to one plan”) does the same as above for scans but first shows the Import RoomPlan dialog:

Plans prepared in the iPhone app keep their angles by default; raw scans are straightened by default. A ZIP that already contains an edited iPhone plan is rejected: “This dataset contains an edited iPhone plan. On iPhone, choose Export Editable Plan (JSON) to import its edits; the room.json in this ZIP is the original scan.”

Stitching several scans into one plan. Rooms scanned one at a time each arrive in their own coordinates, so Add to this plan does not guess where the new room belongs: it places the scan 100 cm to the right of everything already on the floor, top edges aligned, on the floor whose level matches the scan’s storey (a storey the project does not have becomes a new floor named after it). The scan keeps its rooms and their names; identifiers that clash with the open project are re-issued, and anything a sibling planner stored in the file (see section 11) travels with the scan. After the import the new walls, openings and furniture are selected, the editor is back on the Select tool, and the view zooms to fit the plan and the new scan together, so you can drag them into place straight away and press R to turn the whole selection in 15° steps. Walls turn only when every wall they touch is selected, so the scan’s loop stays closed; a single wall of a room does not move with R. One Undo (“Added RoomPlan scan”) removes the whole scan again.

To snap the scan into place instead of dragging it, right-click one of its doors and choose Join to another door… (the same button sits under the door’s properties), then click the door it meets in the other room. The hint “Click the door this one meets in the other room. Esc cancels.” shows meanwhile and the first door is marked in amber. The scan — its walls with their doors and windows, and the furniture, notes and dimensions inside its rooms — turns and slides as one piece until its door lies against the other door on the far side of that wall, one wall thickness apart (the average of the two walls’ thicknesses; a scan’s walls are 15 cm unless the capture says otherwise), because each scan modelled the shared wall from its own side. The joined scan is selected afterwards, so R or a drag still adjusts it. A door of the same room is refused with “Pick a door that belongs to another room.”, doors on curved walls cannot be joined, and only walls that meet corner to corner travel with the door’s room. One Undo (“Joined doors”) puts the scan back where it was.

Plans from OpenKitchen3D, OpenLandscape3D and OpenCatio3D

Those planners export “OpenPlan3D JSON” — the interchange file described in section 11 — and OpenLandscape3D and OpenCatio3D also have an Open in OpenPlan3D button that opens this editor directly with the design (you see “Importing capture from iOS app…”, then a new project), falling back to a file download when the link cannot be made. Open a downloaded file with Export → Import JSON or Build → Import RoomPlan; the new project takes the title the plan had in that planner (other RoomPlan files take the file name). The kitchen, garden or catio arrives as walls, openings, room labels and furniture-sized objects; what the other planner knows and this editor cannot show (cabinet runs, plants, structures) stays attached to the project and is written back by Download interchange JSON and the Open in … items.

Import project package (library page or Export menu)

On the library page (or the Welcome screen) choose Import project package (“Bring an edited plan and its attachments from iPhone or another browser. Files stay on this device.”), then Choose project package. A preview shows “3 floors · 24 walls · 5 attachment files” and any notices, for example that “Photos, item notes and costs travel with this package and can be edited in Item details.” Import as copy adds it to the library; “Import creates an independent copy. Existing projects and work in other tabs stay available.” Packages must be under 64 MiB.

In the editor, Export → Import project package opens the same dialog. After Import as copy the plan you were editing is saved and the editor switches to the imported copy; if it cannot be opened here, the copy is still in the library and the reason is shown after you close the dialog.

Tracing an image

To draw over an existing plan or sketch:

  1. Build → Import Image (“Floor plan background”) and choose an image, or copy an image and press Ctrl+V with the canvas focused (paste only places an image when nothing from the plan is on the internal clipboard). Images over 5 MB still import and show the note “Large image imported. The image is larger than 5 MB and may slow down the editor.” under the button.
  2. The image appears on the current floor at reduced opacity. Click it to open Background Image in Properties: Opacity, Scale, Rotation, Set Scale and Remove Image.
  3. Set Scale: click two points on the image whose real distance you know, then answer “Enter the real-world distance between these two points (in cm):”. The image is rescaled so the plan matches.
  4. Draw walls (W) over the image. Each floor can have its own image. Images are saved inside the project (and in JSON exports), so very large images make the project large.

13. iPhone app handoff

The OpenPlan3D iPhone app scans a room and can hand the result to the web editor in two ways.

Link or QR code. In the app, choose Open in OpenPlan3D. The app uploads the plan and shows a link of the form https://app.openplan3d.com/editor?import=CODE (codes use letters and digits but never I, O, 0 or 1). Opening it shows “Importing capture from iOS app…” and creates a new project named “Room Capture CODE” (a plan sent by OpenLandscape3D or OpenCatio3D keeps the title it had there); the address then changes to the project’s own ?id= link, so reloading does not import twice. The upload is temporary: files are removed after about one day, and the app reuses the same link for an unchanged plan for up to 24 hours, so sharing again gives the same code until something changes. If you see “Capture code CODE was not found. It may have expired — share it again from the iOS app.”, generate a new link in the app. The link route is limited to 1 MiB per capture.

Files (no upload). In the app, Export Editable Plan (JSON) saves a file you can AirDrop or send to yourself and open with Export → Import JSON or Build → Import RoomPlan. To also bring photos, notes, costs and the original scan data, use the app’s Export Project Package (ZIP) and the web library’s Import project package; packages exported from the web editor can be imported back into the app the same way. Details of what survives the round trip are in project-package-v1.md and handoff-format-v1.md.

14. Sharing with an assistant

Export → Share with Assistant… uploads a copy “for seven days so an assistant such as Claude can summarize it, review its photos or build a contractor handoff.”

  1. Decide whether to Include photos (“Photos attached to rooms and items. Retained original data and unattached files are never uploaded.”) and read the notice: “The plan, notes and chosen photos go to app.openplan3d.com and are deleted after seven days or when you remove the share.”
  2. Click Share. You get a Share code and a Secret with Copy buttons. “Give both to the assistant when it asks. The secret is shown only here.”
  3. In Claude, add the connector once: “Settings → Connectors → Add custom connector → https://app.openplan3d.com/mcp”, then ask for a summary, photo review or handoff and paste the code and secret when prompted.
  4. Remove share now deletes the copy immediately (“The share was removed. The code and secret no longer work.”).

A share with photos may be up to 64 MiB, without photos 16 MiB. The assistant can only read the share; it cannot change your project. If the service is turned off or busy you will see “Could not share this project.” — try later or send the project package file instead.

15. Keyboard shortcuts

Press ? in the editor to see this list on screen (Copy All copies it; User guide opens this page).

Keys Action
V Select tool
W Wall tool
D Door tool (last chosen type)
H Pan mode
M Measure tool
N Dimension (annotate) tool
T Text tool
S Switch snap step: 25 cm grid or 10 cm (status bar Snap)
G Toggle grid
F / Shift+F Zoom to fit / Fit selection
+ / − (also = / _ and the numpad keys) Zoom in / out, 25% steps between the minimum zoom and 1000%
L Toggle Layers panel
Tab Toggle 2D / 3D
? Show shortcuts
Ctrl+K or / Command Palette
Ctrl+P Print Layout
Ctrl+S Save project
Ctrl+Z / Ctrl+Y (or Ctrl+Shift+Z) Undo / Redo
Ctrl+C / Ctrl+V Copy / Paste selection
Ctrl+A / Ctrl+D Select all / Deselect all
Esc Cancel the current tool, drawing or door join, deselect
R Rotate selection (15° steps; walls included when several things are selected; also rotates the placement preview)
Delete / Backspace Delete selected
Ctrl+L Lock / Unlock
Ctrl+G / Ctrl+Shift+G Group / Ungroup
Mouse wheel or pinch Zoom
Space+drag, middle button, or Shift+drag on empty canvas Pan
Shift+click Add to / remove from selection
Ctrl+click Select one member of a group
Double-click (wall tool) Finish the wall chain
C (wall tool) Close the wall loop
Shift (wall tool) Lock the angle to 45° steps
digits + Enter (wall tool) Place the wall at the typed length
Alt+drag middle handle Curve a wall
Alt+drag end handle Move a wall corner freely (no snapping)
Shift+drag end handle Keep the wall on the nearest 45° step
Shift while resizing Keep proportions
WASD / arrows / mouse / Shift / Esc (walkthrough) Look / move / look / sprint / exit

Shortcuts are ignored while you type in a text field, and most are disabled while a dialog is open. Ctrl / Cmd with + / − is left to the browser, so page zoom keeps working.

16. Troubleshooting

Messages are quoted as the editor shows them.

Saving and storage

Importing

Exporting

3D and models

General

17. Getting help

The User guide links in the editor — in the Keyboard Shortcuts (?) dialog, in the top bar’s More menu and on the project library page — open this page in a new tab. Report problems and ask questions at https://github.com/laanlabs/openPlan3D/issues. The Bug report template asks for:

Before filing, try the current release in a fresh tab, and keep a Download JSON of the affected project so the problem can be reproduced.