README.md
January 26, 2026 ยท View on GitHub

PRISM Dashboard
A modern, glassmorphism-inspired dashboard and custom-cards for Home Assistant.
Dashboard Configuration
Custom Cards
Table of Contents
- What is Prism?
- Features
- Requirements
- Installation
- Project Structure
- Available Custom Cards
- Dashboard Configuration
- Support / Feedback
- Development
- Contributing
- Sponsorship
- Keywords
What is Prism?
Prism is a modern, responsive Home Assistant dashboard with a glassmorphism design.
It combines semi-transparent "frosted glass" surfaces with neumorphism elements for haptic feedback and uses smart YAML anchors to keep the code lean, consistent, and easy to maintain.
Prism is optimized for wall tablets and smartphones and is ideal as a central smart home hub for everyday use.
๐ Note: The dashboard configuration (YAML) was completely hand-written by me.
The custom JavaScript cards were developed with AI assistance (Cursor AI).
Features
-
๐ Glassmorphism UI
Semi-transparent "Frosted Glass" cards with blur effects for a modern, premium look. -
๐ Haptic Feedback (Neumorphism)
Active buttons appear "pressed" and provide visual feedback on interactions. -
๐งญ Smart Navigation
Animated navigation bar that automatically highlights the current room or active view. -
๐ Status Glow
Icons glow in appropriate colors depending on state (e.g., green for security, orange for heating). -
๐ฑ Responsive Grid
Layout seamlessly adapts to different devices (tablet on the wall, smartphone in hand). -
๐จ๏ธ Advanced 3D Printer Support
Full-featured cards for Bambu Lab, Creality, and generic Klipper/Moonraker printers with:- AMS/CFS filament system visualization
- 3D model preview (cover image)
- Multi-printer camera view
- Real-time temperature, progress, layer info
- Pause/Resume/Stop controls
-
๐งน Clean Code with YAML Anchors
Uses YAML anchors (&and*) to avoid repetition and keep global style changes centralized.
Requirements
For this dashboard to work, the following frontend integrations must be installed via HACS (Home Assistant Community Store):
-
Mushroom Cards
Base for almost all cards in the dashboard. -
card-mod
Essential for CSS and glassmorphism styling. -
layout-card
Enables the responsive grid layout (sidebar + main area). -
kiosk-mode
Hides Home Assistant header and sidebar for a clean fullscreen look. -
mini-graph-card
Required for the temperature graph in the sidebar (prism-sidebarandprism-sidebar-light). The sidebar uses mini-graph-card to display accurate temperature history graphs matching Home Assistant's native graph style. -
browser_mod
Important for popups (e.g., calendar, vacuum control).
Installation
Option 1: Installation via HACS (Recommended)
- Make sure HACS is installed.
- Go to HACS โ Frontend (three-dot menu top right) โ Custom Repositories
- Add this repository:
- Repository:
https://github.com/BangerTech/Prism-Dashboard - Type:
Dashboard
- Repository:
- Search for "Prism Dashboard" and click "Download"
- Restart Home Assistant
โจ That's it! HACS automatically registers the resource. All 29 custom cards (dark + light themes) are included in this single file and will receive automatic cache updates via HACS.
Option 2: Manual Installation
- Download or clone this repository.
- Copy the contents of the
wwwfolder to your Home Assistant configuration folder under
/config/www/. - The background image should then be accessible at
/local/background/background.png. - Note: Restart Home Assistant if the
wwwfolder was newly created or newly added.
2. Create Dashboard
- Navigate to Settings โ Dashboards in Home Assistant.
- Click "Add Dashboard" โ Select "New Dashboard from Scratch".
- Make the following settings:
- Title:
Prism(or a title of your choice) - View Type:
Grid (layout-card)(if available, otherwise define it later in the code)
- Title:
Note: For dashboard configuration and adjustments, see Dashboard Configuration and Dashboard README.
3. Register Custom Cards (Manual Installation Only)
If you chose Option 2 (manual installation), the custom cards must be registered manually:
- Navigate to Settings โ Dashboards in Home Assistant.
- Click "Resources" (top right).
- Click "Add Resource".
- Add the bundled resource:
- URL:
/local/custom-components/prism-dashboard.js - Type:
JavaScript Module
- URL:
- Restart Home Assistant so the custom cards are loaded.
โจ All 29 cards are included! The bundled file contains all dark and light theme cards.
Project Structure
Prism-Dashboard/
โโโ custom-components/ # JavaScript Custom Cards (prism-heat.js, prism-button.js, etc.)
โ โโโ images/ # Images for Custom Cards
โ โโโ README.md # Custom Cards Documentation
โโโ dashboard/ # Dashboard Configuration
โ โโโ prism-dashboard.yml # Main Dashboard Configuration
โ โโโ components/ # Reusable YAML Components
โ โ โโโ custom-card.yml # Template for Standard Cards
โ โ โโโ navigation-bar.yml # Navigation Bar
โ โ โโโ sidebar.yml # Sidebar Component
โ โโโ README.md # Dashboard Components Documentation
โโโ www/ # Static Files for Home Assistant
โ โโโ background/ # Background Images
โ โโโ custom-components/ # Compiled Custom Cards
โโโ README.md # This File
Note: The dashboard components in the
dashboard/components/folder are reusable YAML templates. See Dashboard README for details on usage.
Available Custom Cards
Prism Dashboard includes 29+ custom cards (including dark and light theme variants):
Room & Navigation
- prism-room โ Compact room overview with grouped entities and popup
- prism-navigation โ Floating navigation bar for dashboard views
- prism-spacer โ Invisible placeholder for layout spacing
Climate Control
- prism-heat / prism-heat-light โ Circular thermostat knob with drag control
- prism-heat-small / prism-heat-small-light โ Compact heating card
Lights
- prism-button / prism-button-light โ Entity button with brightness slider
- prism-led / prism-led-light โ RGB light with color wheel and temperature control
Covers & Shutters
- prism-shutter / prism-shutter-light โ Horizontal shutter card
- prism-shutter-vertical / prism-shutter-vertical-light โ Vertical shutter card
Media & Calendar
- prism-media / prism-media-light โ Media player card
- prism-calendar / prism-calendar-light โ Calendar events card
Cleaning
- prism-vacuum / prism-vacuum-light โ Vacuum robot card
- prism-vacuum-switchbot โ Specialized card for SwitchBot vacuums
Energy
- prism-energy โ Energy flow visualization with animations
- prism-energy-horizontal โ Horizontal energy flow layout
3D Printing
- prism-3dprinter โ Generic 3D printer card for Moonraker/Klipper (Voron, Prusa, RatRig, etc.)
- prism-bambu โ Bambu Lab printer with AMS support, cover image, multi-printer view
- prism-creality โ Creality printer with CFS support (same design as AMS), cover image, multi-printer view
- Supports: K1, K1C, K1 Max, K1 SE, K2, K2 Plus, Ender 3 V3 series
- Integrations: ha_creality_ws (recommended) or Moonraker
Dashboard Layout
- prism-sidebar / prism-sidebar-light โ Full sidebar with camera, weather, calendar
๐ Full documentation for all cards available in Custom Components README
Dashboard Configuration
The dashboard configuration is located in the dashboard/ folder. There you will find:
prism-dashboard.ymlโ The complete dashboard configurationcomponents/โ Reusable YAML components (Sidebar, Navigation, etc.)
Setup Dashboard
- Open your dashboard in Home Assistant
- Go to Edit โ Raw Configuration Editor
- Copy the contents of
dashboard/prism-dashboard.ymlinto it - IMPORTANT: Adjust all entities to your hardware (see Dashboard README)
- Save the changes
Customization
For detailed information on:
- Adjusting entities โ See Dashboard README
- Using components โ See Dashboard README
- Adjusting styles โ See Dashboard README
- Configuring custom cards โ See Custom Components README
Support / Feedback
For bugs, questions, or feature requests:
- GitHub Issues: Please use the "Issues" tab of this repository.
- Alternatively: Contact me directly (e.g., via your preferred profile, if linked here).
Feedback, suggestions, and screenshots of your own setups are always welcome!
Development
Built with AI assistance (Cursor AI)
The cards were created collaboratively using AI-assisted development. All features have been tested and the code is actively maintained.
Contributing
Contributions are explicitly welcome:
- Fork the repository.
- Create your own branch (
feature/...orfix/...). - Make changes and test them.
- Open a pull request and briefly describe what was changed.
Sponsorship
If you like Prism and want to support further development:
Feel free to use the Support button above
Thank you for your support! ๐
Keywords
home-assistant, dashboard, glassmorphism, lovelace, mushroom-cards, yaml, smart-home, ui-design, hacs, minimalist