Skip to content

Latest commit

 

History

1,337 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Prism

A subscription-free, self-hosted family dashboard that integrates with the tools you already use without becoming yet another system of record.

License Test Install Docker Platforms

Prism is a configurable family dashboard designed for large wall-mounted screens and handheld tablets. It connects to Google Calendar, Microsoft To Do, OneDrive, Apple iCloud (CalDAV), Kroger / Mariano's, and more, and surfaces the information your family actually needs in one place. Built for people who value privacy, hate subscriptions, and are comfortable with Docker.

📖 Full documentation: https://sandydargoport.github.io/prism/


Prism dashboard in dark mode

See the full screenshot gallery and feature tour →


Quick start

Option 1: Clone and build (any platform)
git clone https://github.com/sandydargoport/prism.git
cd prism
bash scripts/install.sh
Option 2: Pull pre-built image (includes Raspberry Pi / ARM64)
curl -O https://raw.githubusercontent.com/sandydargoport/prism/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/sandydargoport/prism/master/.env.example
cp .env.example .env
docker-compose up -d
Option 3: Home Assistant add-on (no terminal, no certs)

In Home Assistant, go to Settings → Add-ons → Add-on store, open the ⋮ menu in the top right, choose Repositories, and paste:

https://github.com/sandydargoport/prism

Find Prism in the store, click Install, then Start on the Info tab. Postgres and Redis run inside the add-on container, and all state lives under Home Assistant's /data volume, so add-on updates and HA snapshots keep your family's history.

Add-ons are not distributed through HACS, so the custom-repository flow above is the install path. Options, data layout and troubleshooting: ha-app/README.md.

Open http://localhost:3000 (on the Home Assistant add-on, use the port 3000 link in the add-on panel). A fresh install boots into the setup wizard, where you create family members and set each member's PIN (4 or 6 digits). To try Prism with a fictional demo family instead, set PRISM_DEMO_SEED=true in .env before the first docker compose up; every demo account uses PIN 1234.

Full installation notes (HTTPS / Nginx cert prerequisite, Raspberry Pi notes, troubleshooting) are in the install guide.


What's in the docs

  • Get Started — install, first-time setup, updating
  • User Guide — calendar, shopping, recipes, tasks, goals, mobile PWA
  • Integrations — Kroger / Mariano's cart push, Home Assistant, Voice API for Alexa
  • Changelog — every release

Behind the project

I wanted a family dashboard that connected to the tools we already use and didn't require a monthly subscription. DAKboard is configurable but feels like a solo project that outgrew itself. Skylight is clean but fairly limited. Both offer free tiers that don't go very far, and the paid versions cost money on an ongoing basis. Open-source alternatives like MagicMirror², Homarr, and Home Assistant exist, but they're all built for somewhat different use cases.

The integrations reflect the tools my family actually uses: Microsoft To Do for tasks and shopping, Google Calendar for scheduling, OneDrive for photos, Open-Meteo / OpenWeatherMap for weather, Kroger online cart for groceries.

I'm not a software developer, but I work in a technical field where AI tools are increasingly central to how work gets done. This project was built entirely with Claude Code — I directed requirements, design, and product decisions; Claude Code handled the implementation. I've done what I can to make this solid (CI pipeline, E2E tests, security policy), but I can't make guarantees I'm not qualified to make. Use reasonable judgment about what you expose to the internet.

If something is missing or broken, open an issue or submit a PR.

Contributing

  • Star the repo
  • Report issues you encounter
  • Suggest features that would help your family
  • Submit PRs for improvements

See CONTRIBUTING.md for details.

License

Prism is open-source under the PolyForm Noncommercial 1.0.0 license. Free for personal and non-commercial use.

Acknowledgments

Built with Claude Code. Inspired by frustration with existing solutions. Made better by the self-hosting community.

About

Prism is a subscription-free, self-hosted family dashboard that integrates with the tools you already use without becoming yet another system of record.

Topics

Resources

Contributing

Security policy

Stars

113 stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages