How to use CasaBoard
Learn how to set up and use CasaBoard to create your smart home dashboard for Home Assistant
Quick Start Guide
1. Google OAuth Login
CasaBoard uses Google OAuth for secure authentication. Follow these steps to set up your account:
Access the Login Page
Navigate to the login page and click "Continue with Google"
Google Account Selection
Choose the Google account you want to use for CasaBoard. This will be your primary account for accessing the dashboard.
Grant Permissions
Review and accept the permissions requested by CasaBoard. This allows secure access to your account.
Complete Authentication
Once authenticated, you'll be redirected back to CasaBoard and can start setting up your dashboard.
2. Home Assistant Connection
Connect your Home Assistant instance to CasaBoard to start building your dashboard:
Get Your HA URL
Find your Home Assistant URL (e.g., http://homeassistant.local:8123 or https://your-domain.com)
Create a Long-Lived Access Token
In Home Assistant, go to Profile → Long-lived access tokens → Create token. Give it a name like "CasaBoard" and copy the token.
Enter Connection Details
In CasaBoard, go to Setup → Home Assistant Configuration and enter your HA URL and access token.
Test Connection
Click "Test Connection" to verify that CasaBoard can connect to your Home Assistant instance.
3. Creating Your First Page
Now you're ready to create your first dashboard page:
Go to Pages Management
Navigate to Setup → Pages Management to see your dashboard pages.
Create New Page
Click "Create New Page" and give your page a name (e.g., "Living Room", "Kitchen", "Overview").
Open Page Editor
Click the edit button (pencil icon) next to your new page to open the drag-and-drop editor.
4. Adding Components
Use the drag-and-drop interface to add components to your dashboard:
Available Components:
How to Add:
Drag a component from the left panel to your page
Select the component to configure its properties
Choose the Home Assistant entity to control
Customize appearance and behavior as needed
Tips and Best Practices
Organization
- Create separate pages for different rooms or functions
- Use descriptive names for your pages and components
- Group related components together
Performance
- Don't overload pages with too many components
- Use entity cards for multiple related entities
- Test your dashboard on mobile devices
Troubleshooting
Connection Issues
If you can't connect to Home Assistant:
- • Check that your HA URL is correct and accessible
- • Verify your access token is valid and not expired
- • Ensure your HA instance is running and accessible
- • Check your network connection
Component Issues
If components aren't working properly:
- • Verify the entity ID is correct in Home Assistant
- • Check that the entity is available and not disabled
- • Try refreshing the page or reconnecting to HA
- • Check the browser console for error messages
Getting Help
If you need additional help or have questions:
Documentation
Check our comprehensive documentation for detailed guides and API references.
Community Support
Join our community forum to ask questions and share your experiences.