egmalt / house-planner
git clone https://github.com/egmalt/house-planner.git
v0.1.0 · 22d ago
Self-hosted house planner: true-scale 2D floor plan, 3D, satellite map overlay, sewer, electrical, water and underfloor heating with calculations, priced bill of materials. React + PHP, no database. By the team behind homedesignsai.pro
+5
stars, 24h · #5,772
+~35
stars, 7 days · #5,355
+296
stars, 30 days · #2,738
296
★ total · +13% this week
24
forks · 1 open issues
Star history (as recorded here)
LanguageTypeScript
LicenseMIT
Created2026-10-01 (22d ago)
Last push22d ago
Watchers3
OwnerUser
GitHub topics
3darchitecturebill-of-materialscadconstructionelectrical-designfloor-planfloorplan-editorhome-designhouse-plannerkonvamaplibrephpplumbingreactreact-three-fiberself-hostedthreejstypescriptunderfloor-heating
Links
- GitHub: github.com/egmalt/house-planner
- Homepage: https://app.homedesignsai.pro
- Releases · Issues · Hacker News mentions
README excerpt
# House Planner A self-hosted planner for a private house: true-scale 2D floor plan, 3D preview, satellite overlay, utility networks and a priced bill of materials, all stored on your own PHP hosting. Made by the team behind homedesignsai.pro — an AI that helps you design your home. **English** | Русский 2D plan editor 3D with low walls Read-only phone view Plan on the satellite map Estimate on an A4 sheet Electrical layer with circuits Underfloor heating loops Versions and snapshots **Live demo**: a shared copy without login that resets every hour, see demo mode. The interface is available in English and Russian. ## Features **2D plan editor** - Real-scale drawing in millimetres: walls with thickness and material, doors, windows, garage gates, furniture from a catalog with real dimensions, site zones (gravel fill, lawn, paving). - Snapping to wall ends and a 100 mm grid, dimension lines, a measuring tool (`M`, chained segments), undo/redo. - View rotation in 15° steps and "north up", building selection (`B`) to move or rotate the whole house, room labels with net area detected from the walls. - Area summary: total and living area, rooms, bedrooms, bathrooms, building footprint, plot coverage. **3D** - Two looks: *Model* (clean massing) and *Materials* (textures by wall material and facade finish). - Wall and accent colours from the RAL palette, low-wall modes (1 m and floor level) to see the layout from above, iso/top/front cameras. **Site and map** - Plan overlaid on satellite imagery with geo-referencing (`lat/lng` of the plan origin plus rotation). - Site boundary from GeoJSON (for example, a cadastral parcel), neighbouring parcels from `data/parcel.geojson`, manual imagery alignment. - Optional server-side locked site data: the legal boundary cannot be moved from the editor. **Utility networks** (each one is a layer with its own editor, calculation and estimate group) - **Sewer** with a septic tank: routing from fixtures, risers, cleanouts, outlets; slopes, invert levels, fittings, clearance checks. - **Electrical**: sockets, switches, lights, panel and circuits; auto-routing along walls, cable lengths, breakers and RCDs, load and voltage-drop checks, wet-zone rules (ПУЭ, ГОСТ Р 50571). - **Water supply**: well or borehole, pump, filter, boiler, cold/hot manifolds, home-run piping to fixtures, insulation and heating cable outside. - **Hydronic underfloor heating**: automatic loop layout per room, edge zones, loop splitting at 80 m, heat output vs. heat loss, flow rates and balancing, manifold placement. **Bill of materials** - Quantities are computed from the plan and networks, prices come from a JSON catalog, an A4 print layout. - "Bought" checkboxes with actual price and date, CSV export (Excel-friendly), one-click cart on petrovich.ru (a Russian DIY retailer). **Storage and access** - The plan lives on the server as JSON; every save is a numbered version, plus named snapshots you can restore. - Optimistic concurrency (`If-Match` / `