📈 GH Trending Explorer 🎲 Surprise me

← all repos

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)

2026-10-20 · 281 ★ 2026-10-23 · 296 ★
LanguageTypeScript
LicenseMIT
Created2026-10-01 (22d ago)
Last push22d ago
Watchers3
OwnerUser

GitHub topics

Links

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` / `