Stuga

A beautiful, opinionated Home Assistant dashboard

---

I love Home Assistant. I don't love configuring dashboards.

Stuga is what I wanted: a fast, polished app that just works. Open it, log in, done. Your rooms, devices, and floors are already there. No YAML. No cards. No templates.

Built for my family to actually use.

---

What it does

• Zero config — Reads your HA setup automatically
• In-place editing — Rename rooms, change icons, reorder things. All saved back to HA.
• Mobile-first — Designed for phones. Works on tablets and web too.
• Fast — WebSocket connection, instant updates

---

Get Started

iOS & Android (Recommended)

Native apps work with any Home Assistant setup, including local-only installs.

• iOS — Download on the App Store. Free.
• Android — Get it on Google Play. Free.

Sideload with Obtainium

Prefer to install directly from GitHub? Use Obtainium to get automatic updates:

1. Install Obtainium from F-Droid or GitHub
2. Add app → Enter https://github.com/twinbolt-ab/stuga
3. Obtainium will track releases and notify you of updates

Web

Try the web app at stuga.app/run.

Requirements:

• A public HTTPS URL for your Home Assistant (Nabu Casa, DuckDNS, etc.)
• Add Stuga to your configuration.yaml:

http:
  cors_allowed_origins:
    - https://stuga.app

Local addresses like homeassistant.local won't work from the web due to browser security. Use the native apps for local-only setups.

Self-hosted

Run Stuga on your own server or local network:

npm install
npm run build
# Serve the dist/ folder

Self-hosting on HTTP allows connecting to local Home Assistant without a public URL.

---

Supports

Lights, switches, scenes, climate, covers, fans. More coming.

---

Development

npm install
npm run dev

Built with Vite, React, Tailwind, Framer Motion, and Capacitor.

---

Roadmap

Now:

• Polish based on community feedback

Soon:

• Light temperature support
• Custom tabs (favorite rooms and devices)

Later:

• Edit scenes
• Add new devices through the app
• Automations workflow / custom scripts
• Languages
• Widgets
• More themes
• Multi-instance support
• Apple Watch / Wear OS

---

Feedback

Have ideas or questions? Join the Discussions.

Found a bug? Open an Issue.

---

License

PolyForm Noncommercial 1.0.0 — Free for personal use. No commercial use allowed.

---

Made by Twinbolt in Sweden