🏠 EasyHome3D

Modern 2D Floor Plan Editor & Live 3D Architectural Home Design Studio for Windows

---

⚡ Try It Now (Zero Install, Portable ZIP)

Get the latest release ready-to-run immediately with zero setup or administrative rights required:

📦 Download EasyHome3D Standalone (.zip)

1. Download the EasyHome3D-*-win-x64.zip package from the Latest Release.
2. Unzip into any directory of your choice.
3. Launch EasyHome3D.exe and begin planning your dream home instantly!

---

📸 Application Screenshot

EasyHome3D running the 2D precision plan editor alongside the real-time 3D architectural viewer with live room furnishings and catalog elements.

---

🌟 Overview & Key Capabilities

EasyHome3D is a high-performance, open-source interior design and floor planning application inspired by classic CAD architecture tools such as Sweet Home 3D, reimagined with the modern Windows 11 WinUI 3 fluent design system.

📐 2D Precision Floor Planning

• Wall Drafting: Draw straight, curved, or chained walls with exact millimeter-accurate dimensions, baseboards, and wall thickness configuration.
• Angle Snapping & Magnetic Guides: Automatic 15° angle increments and magnetic alignment for clean corner joins.
• Room Polygon Detection: Create rooms from connected walls or polygon traces, automatically calculating area ($m^2$ or $sq\ ft$) and room labels.
• Dimension Lines & Text Annotations: Annotate spaces, place custom text labels, and draw measurement lines.
• Rulers & Grid System: Dynamic zoom-aware background grid with customizable millimeter/centimeter scale.

🛋️ Rich Furniture & Decor Catalog

• Multi-Category Catalog: Extensive built-in collection including Living Room, Bedroom, Kitchen, Bathroom, Doors & Windows, Lights, and Outdoor items.
• Parametric Transformations: Move, rotate, elevate, scale, and adjust object colors and materials.
• Real-Time Drag & Drop: Seamlessly place furniture directly onto the floor plan from the side catalog.

🌐 Live 3D Architectural Visualization

• Dual-View Rendering: Split-pane view allows editing the 2D layout while observing changes rendered live in 3D.
• Aerial & Virtual Visit Perspectives: Orbit camera for bird's-eye architectural analysis, or virtual walkthrough view to experience room scale from human eye level.
• Directional Lighting & Shading: Realistic depth, elevation modeling, and ambient shading.

📂 File Formats & Ready-Made Samples

• Standardized Project Format: .home3d projects stored as optimized zipped archives containing JSON model definitions.
• Curated Architectural Templates:
  • Modern Suburban Family Villa (143 $m^2$, 3 Bedrooms, 2 Bathrooms, Garden Terrace)
  • Urban Contemporary Apartment (76 $m^2$, 2 Bedrooms, Skyline Balcony)
  • Cozy Country Cottage (Compact warm open-concept plan)

---

🛠️ Architecture & Technology Stack

Component	Technology	Purpose
UI Framework	WinUI 3	Modern fluent desktop interface, controls, and Mica window backdrop
Runtime	.NET 8	High-performance C# runtime with standalone unpackaged deployment
Windows API	Windows App SDK 2.4	Windows desktop application lifecycle, windowing, and title bar customization
2D Graphics Engine	Win2D (Microsoft.Graphics.Win2D)	Hardware-accelerated Direct2D canvas rendering for rapid plan drawing
3D Engine	Pure C# Software 3D Pipeline	Lightweight back-to-front perspective transformation and rasterizer
Storage / Serialization	System.Text.Json & System.IO.Compression	Compact zipped .home3d and .nh3d project documents

---

⌨️ Keyboard Shortcuts & Controls

Shortcut / Key	Context	Action
Ctrl + N	Global	Create a new blank home project
Ctrl + O	Global	Open an existing .home3d project file
Ctrl + S	Editor	Save current home project
Ctrl + Z	Editor	Undo last action
Ctrl + Y / Ctrl + Shift + Z	Editor	Redo action
Delete / Backspace	Selection	Remove selected furniture, wall, or room
Escape	Active Tool	Cancel current drawing operation / switch to Select mode
Space + Drag / Middle Click	2D Plan	Pan canvas
Mouse Wheel	2D / 3D Canvas	Zoom in / out
Right Click + Drag	3D View	Orbit camera perspective

---

🚀 Building from Source

Prerequisites

• Operating System: Windows 10 (Build 19041+) or Windows 11
• .NET SDK: .NET 8.0 SDK or later
• Visual Studio: Visual Studio 2022 (17.8 or newer) with the .NET Desktop Development workload.

Clone & Build

# Clone the repository
git clone https://github.com/uponatime2019/EasyHome3D.git
cd EasyHome3D

# Restore and build the x64 binary
dotnet build "EasyHome3D.csproj" -p:Platform=x64

# Run the application
dotnet run --project "EasyHome3D.csproj" -p:Platform=x64

Produce a Standalone Portable Release

dotnet publish "EasyHome3D.csproj" -c Release -p:Platform=x64 -o "publish/EasyHome3D_Portable"

The output in publish/EasyHome3D_Portable contains a complete standalone zero-dependency folder ready for distribution.

---

🗺️ Roadmap & Upcoming Features

• Pure unpackaged standalone WinUI 3 architecture (zero MSIX / store dependencies)
• Dual-pane 2D CAD floor plan editor and 3D perspective renderer
• Built-in furniture and decor catalog with categorized items
• Architectural sample house blueprints (Villa, Apartment, Cottage)
• Full undo/redo stack and compressed .home3d project format
• Export 3D models to Wavefront .obj and glTF .gltf formats
• High-resolution 2D floor plan rendering to PDF and SVG vector graphics
• Multi-story / multi-level floor plan editing UI
• Custom user-imported 3D furniture models (.obj / .stl)
• Realistic raytraced photo rendering mode

---

🤝 Contributing & Community

Contributions are what make the open-source community an incredible place to learn, create, and inspire. Any contributions you make are deeply appreciated.

• Found a bug? Open an issue on GitHub.
• Want to add a feature or expand the furniture catalog? Fork the project, create a feature branch, and submit a PR!
• Please read our CONTRIBUTING.md guide before submitting pull requests.

---

📄 License

EasyHome3D is distributed under the permissive MIT License. See LICENSE for details.