Required for all Ultra Card users. Install once to get the Ultra Card Hub sidebar in Home Assistant. Pro subscribers also get their subscription synced automatically across every device.
This Home Assistant integration connects your HA instance to ultracard.io, adds the Ultra Card Hub sidebar panel available to everyone, and — for Pro subscribers — automatically unlocks Pro features on every device connected to your Home Assistant.
Installing Ultra Card Connect adds the Ultra Card Hub to your Home Assistant sidebar — a dedicated panel with everything you need to manage your Ultra Cards across all your dashboards:
- Favorites — save your most-used card configurations for quick access
- Presets — community and custom presets to style your cards instantly
- Colors — manage your color palette across all cards
- Variables — create global variables reusable across all your cards
- Templates — manage and reuse Jinja templates
- Dashboard — see stats across all your dashboards at a glance
- Pro — view your subscription status and unlock Pro features
Everything above, plus:
- Auto-sync Pro features — desktop, mobile, tablet, TV — all unlocked automatically with one login
- No per-device login — no more signing in separately on every browser or device
- Auto-Refresh — token refreshes automatically every 55 minutes, never expires
- Dashboard Snapshots — full backup and restore of your entire dashboard layout
- Cloud Backup — 30 manual backups across all your cards
- Priority Support — Discord support for Pro members
Without Ultra Card Connect:
- There is no Ultra Card Hub sidebar — Favorites, Presets, Colors, and Variables are not accessible outside of the card editor
- Pro users must log in separately on every device (desktop, phone, tablet, TV)
- Sessions expire and require re-login each time on each device
Install Ultra Card Connect once and:
- The Ultra Card Hub sidebar appears on every device connected to your Home Assistant ✅
- Free users get full access to Favorites, Presets, Colors, Variables, and Templates in the sidebar ✅
- Pro subscribers get all of the above plus their subscription synced across every device automatically ✅
- Set it and forget it ✅
Open your Home Assistant and add this repository in HACS:
Or search manually in HACS:
- Open HACS in Home Assistant
- Click Integrations
- Search for "Ultra Card Connect"
- Click Download
- Restart Home Assistant
Or add as a custom repository:
- Open HACS → click the ⋮ menu → Custom repositories
- Add URL:
https://github.com/WJDDesigns/ultra-card-connect - Category: Integration
- Click Add
- Find Ultra Card Connect and click Download
- Restart Home Assistant
- Go to Settings → Devices & Services
- Click + Add Integration
- Search for "Ultra Card Connect"
- Enter your ultracard.io username or email
- Enter your password
- Click Submit
✅ Done! The Ultra Card Hub sidebar is now active on all your devices.
- Look for Ultra Card in your Home Assistant sidebar — click it to open the Hub
- Open the Pro tab inside the Hub
- Free users: you'll see your account details and Pro upgrade options
- Pro subscribers: you'll see "Connected via Ultra Card Connect" with your active subscription details
- Open the Hub on your phone, tablet, or another browser — it's already there ✅
- Home Assistant 2024.1.0 or newer
- A ultracard.io account — free accounts are supported
- Ultra Card installed via HACS (the card, not just this integration)
┌─────────────────────────────────────────────────┐
│ Home Assistant Instance │
│ ┌───────────────────────────────────────────┐ │
│ │ Ultra Card Connect Integration │ │
│ │ • Authenticates with ultracard.io │ │
│ │ • Manages JWT tokens automatically │ │
│ │ • Refreshes every 55 minutes │ │
│ │ • Adds Ultra Card Hub to the sidebar │ │
│ │ • Exposes subscription state to cards │ │
│ └───────────────────────────────────────────┘ │
│ ↓ │
│ ┌───────────────────────────────────────────┐ │
│ │ Ultra Card (on any device) │ │
│ │ • Hub sidebar visible to all users │ │
│ │ • Reads subscription tier automatically │ │
│ │ • Unlocks Pro features if subscribed │ │
│ └───────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
↓ ↓ ↓
[Desktop] [Mobile] [Tablet]
Hub Sidebar ✅ Hub Sidebar ✅ Hub Sidebar ✅
(Pro if subscribed) (Pro if subscribed) (Pro if subscribed)
Technical Details
- Authentication: Uses ultracard.io JWT API (
/jwt-auth/v1/token) - Token Refresh: Automatic every 55 minutes (before 1-hour expiry)
- Grace Period: Pro access maintained for 24 hours if server is temporarily unreachable
- Security: Credentials encrypted in HA config entry, tokens stored in memory only
- Card Detection: Ultra Card reads subscription state automatically on load
Once installed via HACS, you'll be notified of updates automatically. Click Update when available — no reinstall or reconfiguration needed.
If you change your ultracard.io password:
- Go to Settings → Devices & Services
- Find Ultra Card Connect
- Click Configure
- Enter your new credentials
- Click Submit
- Verify the integration is loaded: Settings → Devices & Services → Ultra Card Connect — it should show as "Loaded"
- Hard refresh your browser: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
- Check logs: Settings → System → Logs — search for
ultra_card_pro_cloud - If still missing, try removing and re-adding the integration, then restart Home Assistant
- Open the Hub sidebar → click the Pro tab
- Verify it shows "Connected via Ultra Card Connect" with subscription status PRO / Active
- If it shows your account but the wrong tier, your subscription may have expired — check at ultracard.io
- Check logs for
ultra_card_pro_clouderror messages
- ❌ Invalid credentials — verify your username and password at ultracard.io
- ❌ Cannot connect — check that Home Assistant can reach the internet and that ultracard.io is accessible
- ❌ Integration shows "Failed to Setup" — check HA logs, verify
https://ultracard.io/wp-json/jwt-auth/v1/is reachable, try removing and re-adding
If you had "Ultra Card Pro Cloud" installed before this rename, nothing breaks. The internal domain (ultra_card_pro_cloud) and sensor entity (sensor.ultra_card_pro_cloud_authentication_status) are unchanged. You will simply receive a HACS update notification — click Update, restart Home Assistant, and you're done.
Each Home Assistant user account can have its own Ultra Card Connect integration configured with separate ultracard.io credentials. Each user sees their own Hub sidebar and their own subscription status independently.
This integration uses a single source of truth for version numbers.
To change the version, edit version.py in the root folder:
__version__ = "1.0.9" # Change thisThen sync to manifest (required before deploying):
npm run version:update
npm run deploySee VERSION_GUIDE.md for detailed documentation.
See CHANGELOG.md for the full version history.
- Issues: GitHub Issues
- Feature Requests: GitHub Discussions
- Get Pro Subscription: ultracard.io
MIT License — see LICENSE file for details.
Created by WJD Designs for the Home Assistant community.
Uses the ultracard.io authentication API.
If Ultra Card Connect makes your life easier, consider upgrading to Pro to support continued development! ❤️