Maket turns a floor plan (DXF or JSON) into a walkable 3D model with an animated build-up. The conversion runs in your browser and is free. Since September 2026 plans live inside projects, so a building with several floors is one project with several plans, each with its own floor index. This guide covers the project model, the plan workflow, what is saved, and how to do the same from the terminal.

Why projects

Maket started as "drop a plan, walk through it", which is fine for a flat and wrong for a building. A house has a ground floor and a first floor; an office has six. A project is a folder for one building; each floor plan is a plan inside it. Uploading without a project is blocked with a hint, because plans belong somewhere. The data model is built so floors can later be stacked into one building you can walk through top to bottom.

Create a project first

Open Maket, type a project name and press Create project. Nothing is uploaded yet; the project is a folder. Projects are listed under Maket in the sidebar with their plan counts, and on the Maket page as a list with a create box. Open a project and you see its plans as cards with thumbnails.

Add plans

Inside the project press Add plan or drop a DXF/JSON file onto the scene. The plan is saved immediately under the file's name, the 3D model is built and the animation plays. Add the next floor the same way; plans keep a floor index so ground, first and second floors stay in order. Use the --floor convention from the start (0 for ground, 1 for first) and the project stays tidy as it grows.

What Maket reads from the file

Units are read from the DXF header; if missing, Maket guesses from the drawing size and tells you. Each layer gets a role: wall, door, window, room, text, decor or ignore. Common layer names such as A-WALL, DUVAR or A-GLAZ are recognised automatically. Parallel double lines are merged into thick walls, arcs become doors, closed polygons become rooms with names and areas, and doors and windows are attached to the nearest wall and cut into it. Keep dimensions and hatching off the wall layer; anything on it is treated as a wall.

Working in a plan

  • Five build phases play on load: drawing, scan, rise, dress, walk. Press Skip to jump to the finished model, Replay to watch it again.
  • Orbit and Walk modes; Walk is a first-person tour with the keyboard.
  • Floor height slider, and layer roles (wall, door, window, room, decor, ignore) in the Layers panel; changing a role rebuilds the scene instantly.
  • Save stores the current settings and a thumbnail; the thumbnail also becomes the project cover. Thumbnails are captured when the build animation finishes.
  • Export GLB for use in other 3D tools.

Rename and delete

Hover a project or plan name and use the pencil to rename it in place; Enter saves, Escape cancels. The trash icon deletes; deletion is soft, so nothing is destroyed on the server and support can restore it. Deleting a project removes its plans from your lists the same way.

Reopening a plan

Open the project, click the plan card, and the model rebuilds from the saved file with the layer roles and floor height you saved. Because the conversion runs locally, reopening costs nothing. If the file has changed in your CAD tool, add it as a new plan rather than expecting the old one to update.

From the command line

The yesilcam CLI mirrors the model: maket create "Villa", then maket save ground.dxf --project 12 --floor 0, and maket plans 12 to list a project's plans. maket analyze plan.dxf reads a file without saving it, and --json gives machine-readable output. The MCP server exposes the same verbs, so an assistant connected to it can create a project and save floors on your behalf. See the Developers guide for installation and sign-in.

Checklist for a clean import

  1. Export one DXF per floor from your CAD tool, with units set in the header.
  2. Put walls, doors, windows and rooms on their own layers with recognisable names.
  3. Create the project, then add floors in order with matching floor indexes.
  4. Check the Layers panel on each plan and correct any role that was guessed wrong.
  5. Save each plan so its settings and thumbnail persist.

Frequently asked

Does Maket cost tokens? No. The conversion runs in your browser and is free; saving projects and plans is included in your account.

Can I upload a plan without a project? No. The upload is blocked with a hint; create a project first, then add the plan inside it.

Is a deleted plan gone for good? No. Deletion is soft; nothing is destroyed on the server, and support can restore it.

Which file formats are supported? DXF exported from a CAD tool, or a JSON plan. GLB is the export format for other 3D tools.