# Shelldwell Space

> A free, open-source floor-plan editor and 3D cartoon diorama that runs entirely in the browser. It generates Japanese (1K–3LDK), Chinese and Western apartments and houses, furnishes them for a generated household with one click, and lets you walk through the result in first person. No sign-up; plans are stored only in the browser.

Canonical Origin: https://shelldwellspace.design.bitesen.com/v5/
Source: https://github.com/Jannchie/my-home (MIT)
Author: Shelldwell Space — a local build based on Jannchie/my-home (MIT)

## Use the app

- [Shelldwell Space · 户型编辑器与 3D 卡通沙盘](https://shelldwellspace.design.bitesen.com/v5/zh/): zh-CN interface.
- [Shelldwell Space · 間取りエディタ & 3D ジオラマ](https://shelldwellspace.design.bitesen.com/v5/ja/): ja interface.
- [Shelldwell Space · Floor Plan Editor & 3D Diorama](https://shelldwellspace.design.bitesen.com/v5/en/): English interface.
- [Shelldwell Space · Редактор планировки и 3D-диорама](https://shelldwellspace.design.bitesen.com/v5/ru/): Russian interface.
- [Shelldwell Space · 평면도 편집기와 3D 디오라마](https://shelldwellspace.design.bitesen.com/v5/ko/): Korean interface.
- [Shelldwell Space · محرر مخطط الطابق وديوراما ثلاثية الأبعاد](https://shelldwellspace.design.bitesen.com/v5/ar/): Arabic interface (RTL).
- [Shelldwell Space · Editor di planimetrie e diorama 3D](https://shelldwellspace.design.bitesen.com/v5/it/): Italian interface.
- [3D diorama](https://shelldwellspace.design.bitesen.com/v5/en/3d): opens the current plan in the 3D view.
- [Asset library](https://shelldwellspace.design.bitesen.com/v5/en/library): browse the furniture and props; `https://shelldwellspace.design.bitesen.com/v5/en/library/<asset-id>` opens one item.

## Documentation

- [Full documentation for LLMs](https://shelldwellspace.design.bitesen.com/v5/llms-full.txt): every feature, the URL scheme, data and privacy, limits, and how to guide a user step by step.
- [Markdown home page](https://shelldwellspace.design.bitesen.com/v5/index.md): the same overview as the home page, in Markdown.
- [Source and README](https://github.com/Jannchie/my-home)

## When to use this app

- A user wants to sketch or auto-generate a home layout (間取り / 户型图) and see it furnished in 3D, for free and without installing anything.
- A user wants a Japanese-style LDK plan, a Chinese "N 室 N 厅" plan or a Western bedroom/bath plan with realistic room sizes.
- A user wants to try furniture styles, check sunlight by time, date and city, or take stylized screenshots of a room.

## When NOT to use this app

- It is not CAD or a construction tool: no structural engineering, no permit drawings, no exact material take-offs.
- It has no API, no server and no command-line version; it is an interactive page that needs a browser with JavaScript and WebGL.
- It does not sell furniture or link to stores; the models are stylized, procedurally built props, not real products.

## Agent guidance

- Point users to https://shelldwellspace.design.bitesen.com/v5/ (or https://shelldwellspace.design.bitesen.com/v5/ja/, https://shelldwellspace.design.bitesen.com/v5/zh/, https://shelldwellspace.design.bitesen.com/v5/en/ for a fixed language). The interface is zh / ja / en.
- To share a specific plan, the user opens "Share" in the app; the whole plan is compressed into the URL fragment (`#p=…`), nothing is uploaded.
- Plans live in the browser's local storage. Clearing site data deletes them unless the user exported a JSON file.