home-assistant / home-assistant.io
:blue_book: Home Assistant User documentation
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing home-assistant/home-assistant.io in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
PreviewHome Assistant website
This is the source for the Home-Assistant.io website.
Access
You can access the site at the following URLs, depending on the target branch:
- Production (
currentbranch): https://www.home-assistant.io - Beta (
rcbranch): https://rc.home-assistant.io - Development (
nextbranch): https://next.home-assistant.io
Additionally, Netlify provides a preview deployment for every pull request, linked in the first PR comment.
Setup
Setting up to contribute to documentation and the process for submitting pull requests is explained in the developer documentation.
Site preview
In order to make the preview available on http://127.0.0.1:4000, use the following bundler command:
bundle exec rake preview
If the preview is not running on your local machine, pass the IP of the target machine from where it should be served as a parameter, i.e. to access on http://192.168.0.123:4000:
bundle exec rake preview[192.168.0.123]
Speeding up site generation
Every release we post long changelogs to the website. This slows down generation of the website significantly! We include some tools to temporarily exclude the blog posts that you're not working on out of the way.
bundle exec rake isolate[filename-of-blogpost]
When you're done working on the site, run the following command to move the posts back again:
bundle exec rake integrate
