{"id":49305388,"url":"https://github.com/alertua/ha-public-dashboard","last_synced_at":"2026-04-26T09:04:50.451Z","repository":{"id":334775022,"uuid":"1142698023","full_name":"ALERTua/ha-public-dashboard","owner":"ALERTua","description":"A Home Assistant integration that provides a public dashboard capable to display home assistant entity cards","archived":false,"fork":false,"pushed_at":"2026-04-12T13:21:43.000Z","size":1458,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-12T15:18:07.438Z","etag":null,"topics":["dashboard","homeassistant","homeassistant-addon"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ALERTua.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-26T18:39:31.000Z","updated_at":"2026-04-12T13:21:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ALERTua/ha-public-dashboard","commit_stats":null,"previous_names":["alertua/ha-public-dashboard"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ALERTua/ha-public-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALERTua%2Fha-public-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALERTua%2Fha-public-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALERTua%2Fha-public-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALERTua%2Fha-public-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ALERTua","download_url":"https://codeload.github.com/ALERTua/ha-public-dashboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALERTua%2Fha-public-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32291347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T08:29:33.829Z","status":"ssl_error","status_checked_at":"2026-04-26T08:29:18.366Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","homeassistant","homeassistant-addon"],"created_at":"2026-04-26T09:04:20.447Z","updated_at":"2026-04-26T09:04:50.445Z","avatar_url":"https://github.com/ALERTua.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Public Dashboard Add-on Repository\n\n[![GitHub Release][releases-shield]][releases]\n[![GitHub Activity][commits-shield]][commits]\n[![License][license-shield]](LICENSE)\n\nHome Assistant add-on repository for Public Dashboard.\n\n## Add-ons\n\nThis repository contains the following add-on:\n\n### [📊 Public Dashboard](./public-dashboard)\n\n![Supports aarch64 Architecture][aarch64-shield]\n![Supports amd64 Architecture][amd64-shield]\n\nA secure, dynamic dashboard for building systems with multi-role admin entity management.\n\n## Installation\n\nAdding this add-ons repository to your Home Assistant instance is pretty straightforward. In the Home Assistant add-on store, a possibility to add a repository is provided.\n\nUse the following URL to add this repository:\n\n```txt\nhttps://github.com/ALERTua/ha-public-dashboard\n```\n\n## Add-ons provided by this repository\n\n### Public Dashboard\n\nA mobile-first dashboard with advanced role-based access control that allows:\n\n#### Public Access\n- View building status without authentication\n- Access to user-configured entities and sensors\n- Real-time status updates every 30 seconds\n\n#### Role-Based Access Control\n- **User Role**: Public access to configured entities only\n- **Admin Role**: Full access to admin dashboard, entity control, and basic management\n- **Superadmin Role**: Complete system management including entity configuration and link management\n\n#### Admin Features\n- Toggle controllable entities (switches, lights, input_boolean)\n- View admin-only entities with enhanced controls\n- Search and manage Home Assistant entities\n- Add/remove entities from user and admin dashboards\n- Manage custom links and information sections\n\n#### Security Features\n- JWT-based authentication\n- Role-based API endpoints\n- Secure password hashing (SHA256)\n- Configurable admin and superadmin passwords\n\n## Access Methods\n\nThe add-on supports multiple access methods:\n\n### 1. Home Assistant Ingress (Recommended)\n- Access via Home Assistant sidebar panel\n- Automatic authentication with Home Assistant\n- No additional configuration required\n\n### 2. Direct Port Access\n- Access via `http://YOUR_HA_IP:8000`\n- Useful for public dashboards or kiosks\n- Enable port in add-on configuration\n\n### 3. Reverse Proxy\n- Point your reverse proxy to `http://YOUR_HA_IP:8000`\n- Supports external domain access\n- Compatible with nginx, Traefik, etc.\n\n## Configuration\n\n### Basic Configuration\n```yaml\nadmin_password: \"your_admin_password\"\nsuperadmin_password: \"your_superadmin_password\"\nlog_level: \"info\"\nssl: false\n```\n\n### Default Credentials\n- **Admin**: username `admin`, password `admin123`\n- **Superadmin**: username `superadmin`, password `superadmin123`\n\n### Environment Variables\n- `ADMIN_PASSWORD`: Admin password (default: admin123)\n- `SUPERADMIN_PASSWORD`: Superadmin password (default: superadmin123)\n- `HA_URL`: Home Assistant URL (default: http://supervisor/core)\n- `JWT_EXPIRE_HOURS`: JWT token expiration (default: 24 hours)\n\n## Development\n\n### Local Development Setup\n```bash\n# Install frontend dependencies\njust fe-install\n\n# Start frontend development server\njust fe-dev\n\n# Build for production\njust fe-build\n\n# Combined setup and start\njust start\n```\n\n### Backend Development\n```bash\n# Install backend dependencies\njust be-install\n\n# Start backend server\njust be-start\n\n# Start with development mode\njust be-dev\n```\n\n### Available Commands\n- `just start`: Complete setup with frontend and backend\n- `just fe-clean`: Clean and reinstall frontend dependencies\n- `just version \u003cVERSION\u003e`: Update version across all files\n- `just lint`: Run pre-commit checks\n\n## Support\n\nGot questions?\n\nYou have several options to get them answered:\n\n- The [Home Assistant Community Forum][forum]\n- The Home Assistant [Discord Chat Server][discord] for general Home Assistant discussions and questions\n- Join the [Reddit subreddit][reddit] in [/r/homeassistant][reddit]\n\nYou could also [open an issue here][issue] on GitHub.\n\n## Contributing\n\nThis is an active open-source project. We are always open to people who want to\nuse the code or contribute to it.\n\nWe have set up a separate document containing our\n[contribution guidelines](CONTRIBUTING.md).\n\nThank you for being involved! 😍\n\n[aarch64-shield]: https://img.shields.io/badge/aarch64-yes-green.svg\n[amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg\n[armhf-shield]: https://img.shields.io/badge/armhf-yes-green.svg\n[armv7-shield]: https://img.shields.io/badge/armv7-yes-green.svg\n[commits-shield]: https://img.shields.io/github/commit-activity/y/ALERTua/ha-public-dashboard.svg\n[commits]: https://github.com/ALERTua/ha-public-dashboard/commits/main\n[discord]: https://discord.gg/c5DvZ4e\n[forum]: https://community.home-assistant.io\n[i386-shield]: https://img.shields.io/badge/i386-yes-green.svg\n[issue]: https://github.com/ALERTua/ha-public-dashboard/issues\n[license-shield]: https://img.shields.io/github/license/ALERTua/ha-public-dashboard.svg\n[reddit]: https://reddit.com/r/homeassistant\n[releases-shield]: https://img.shields.io/github/release/ALERTua/ha-public-dashboard.svg\n[releases]: https://github.com/ALERTua/ha-public-dashboard/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falertua%2Fha-public-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falertua%2Fha-public-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falertua%2Fha-public-dashboard/lists"}