This is the source for the Home Assistant Development documentation.

Documentation is build using Docusaurus.

Running the documentation locally requires NodeJS and Yarn to be installed. Inside a cloned fork of this repository, run:

$ script/setup

This will install docusaurus amongst other things.

$ script/server

It will start a server at localhost:3000. You will need to navigate to the next version of the docs to see your changes applied. To do so click on the version number in the header and select next -> Documentation.

• Create new page in docs/
• Add new doc to website/sidebars.json

You will need to restart the server when creating a new file or make changes to sidebars.json. If you're updating a document, you will only need to refresh your browser to get the latest changes.