# Home Assistant Contributors

> Everything you need to contribute to Home Assistant: code, design, documentation, translations, and community. This is the contributor site of Home Assistant, the open source home automation platform, for everyone who contributes: developers, designers, documentation writers, translators, community moderators, and the people who run releases. It replaces developers.home-assistant.io, design.home-assistant.io, and data.home-assistant.io.

Every page is also available as Markdown: add `index.md` to its URL, like https://contributors.home-assistant.io/core/integrations/config-flow/index.md. The links below go to those Markdown versions. Each area has its own list of all its pages at `/<area>/llms.txt`, and the full text of its pages at `/<area>/llms-full.txt`. The full text of every page of the site is in https://contributors.home-assistant.io/llms-full.txt. That file is large, so prefer the file of the area you need.

## Get started

How the project works, and how to make your first contribution.

- [Get started](https://contributors.home-assistant.io/start/index.md): How the Home Assistant project works, where people talk, and how to make your first contribution, whatever your skills are.
- [Your first contribution](https://contributors.home-assistant.io/start/first-contribution/index.md): Pick the path that fits your skills, and take one small first step. Most paths don't need any code.
- [Use GitHub, without being a developer](https://contributors.home-assistant.io/start/github/index.md): What a repository, issue, fork, branch, commit, and pull request are, and how to make a small change to Home Assistant entirely in your browser.
- [Where we talk](https://contributors.home-assistant.io/start/where-we-talk/index.md): Discord, the community forum, and GitHub. Which place to use for what, and where the people of each area can be found.
- [Report a bug](https://contributors.home-assistant.io/start/report-a-bug/index.md): Which repository to report a bug in, what the bug report forms ask and where to find it, and what happens after you report.
- [Pull requests and reviews](https://contributors.home-assistant.io/start/pull-requests/index.md): How to open a pull request that is easy to review, what happens after you open it, and how to help it get merged. For every repository.
- [Grow as a contributor](https://contributors.home-assistant.io/start/grow/index.md): What comes after your first pull request. Reviewing, triaging, owning an integration, taking on a role, and where it can lead.
- [How the project is organized](https://contributors.home-assistant.io/start/organization/index.md): Who owns Home Assistant, who pays for it, where the work lives, and who decides what gets merged.
- [Our principles](https://contributors.home-assistant.io/start/principles/index.md): What Home Assistant stands for, and how we work together. The values behind the decisions you'll see in reviews and discussions.
- [Contribute with AI tools](https://contributors.home-assistant.io/start/ai-tools/index.md): How to use AI coding tools well when you contribute. What the AI policy asks of you, the instructions and skills the repositories carry for agents, workflows for common tasks, and what to check yourself every time.
- [AI policy](https://contributors.home-assistant.io/start/ai-policy/index.md): The Open Home Foundation AI policy. You can use AI tools when you contribute, but you are responsible for every change you submit, and autonomous agents are not allowed.
- [Licensing and the CLA](https://contributors.home-assistant.io/start/licensing/index.md): Which licenses Home Assistant uses, what the Contributor License Agreement says, and how you sign it.
- [Code of conduct](https://contributors.home-assistant.io/start/code-of-conduct/index.md): How we treat each other in every space where we work together, and what to do when something isn't right.

The pages of this area: [Get started](https://contributors.home-assistant.io/start/llms.txt). Their full text: [Get started, full text](https://contributors.home-assistant.io/start/llms-full.txt).

## Core and integrations

Python, core, and the integration platform.

This area has 190 pages. Below are its starting points. The pages of this area: [Core and integrations](https://contributors.home-assistant.io/core/llms.txt). Their full text: [Core and integrations, full text](https://contributors.home-assistant.io/core/llms-full.txt).

- [Core and integrations](https://contributors.home-assistant.io/core/index.md): Python, core, and the integration platform. Everything you need to build and improve integrations, and to work on Home Assistant Core itself.
- [Your first contribution to core](https://contributors.home-assistant.io/core/first-contribution/index.md): Set up a development environment, find something small to fix, and open your first pull request to Home Assistant Core.
- [Development workflow](https://contributors.home-assistant.io/core/development/index.md): How code gets from your machine into a Home Assistant release. The environment, the tools, the checks, and the review process.
- [Building integrations](https://contributors.home-assistant.io/core/integrations/index.md): Everything an integration is made of, from the manifest and the config flow to fetching data, discovery, and diagnostics.
- [Entities](https://contributors.home-assistant.io/core/entities/index.md): How entities work in Home Assistant Core, and a reference for every entity platform, from sensors and lights to voice and AI.
- [Integration quality scale](https://contributors.home-assistant.io/core/quality-scale/index.md): The tiers and rules that describe how good an integration is, how an integration earns a tier, and how to move it up.
- [How core works](https://contributors.home-assistant.io/core/internals/index.md): The inside of Home Assistant Core. The hass object, events, states, asyncio, authentication, the APIs, and the voice and AI building blocks.

## Frontend

Dashboards, panels, and dialogs.

This area has 35 pages. Below are its starting points. The pages of this area: [Frontend](https://contributors.home-assistant.io/frontend/llms.txt). Their full text: [Frontend, full text](https://contributors.home-assistant.io/frontend/llms-full.txt).

- [Frontend](https://contributors.home-assistant.io/frontend/index.md): The web interface of Home Assistant. How it is built, how to work on it, and how to extend it with your own cards, panels, and dashboards.
- [Your first frontend contribution](https://contributors.home-assistant.io/frontend/first-contribution/index.md): Set up the frontend, run it against a Home Assistant instance, make a small change, and open your first pull request.
- [Development](https://contributors.home-assistant.io/frontend/development/index.md): Everything you need to work on the frontend itself. The environment, running it, the gallery and the demo, coding guidelines, tests, and review.
- [Frontend architecture](https://contributors.home-assistant.io/frontend/architecture/index.md): How the frontend is put together, from the first script that loads to the panels, dialogs, and the data that flows through them.
- [Custom cards and more](https://contributors.home-assistant.io/frontend/custom-ui/index.md): Build cards, card features, badges, views, dashboard strategies, and panels that people load into their own Home Assistant, without changing the frontend.
- [Extend the frontend](https://contributors.home-assistant.io/frontend/extending/index.md): Changes to the frontend that go together with a change in Core, like a more-info view for a new domain or a WebSocket command for an integration.
- [Frontend reference](https://contributors.home-assistant.io/frontend/reference/index.md): Commands, the hass object, and the bridge between the frontend and the companion apps. The details you look up.

## Apps

Package software that runs next to Home Assistant.

This area has 42 pages. Below are its starting points. The pages of this area: [Apps](https://contributors.home-assistant.io/apps/llms.txt). Their full text: [Apps, full text](https://contributors.home-assistant.io/apps/llms-full.txt).

- [Apps](https://contributors.home-assistant.io/apps/index.md): Package software that runs next to Home Assistant, managed by the Supervisor. Build an app, test it, and share it with everyone.
- [Contribute to the official apps](https://contributors.home-assistant.io/apps/first-contribution/index.md): Help improve the official apps, the base images, and the build tooling that every app relies on. Build your first app, then pick where to help.
- [Your first app](https://contributors.home-assistant.io/apps/first-app/index.md): Build a "Hello world" app, install it on your own Home Assistant, and grow it into a small web server with options.
- [Build a real app](https://contributors.home-assistant.io/apps/build-a-real-app/index.md): Walk through a complete app, the way experienced app developers set one up. Services with S6 overlay, options with Bashio, translations, documentation, CI, and releases.
- [How apps work](https://contributors.home-assistant.io/apps/how-apps-work/index.md): What the Supervisor does with your app, from the repository to a running container, and the names and folders you run into along the way.
- [App guides](https://contributors.home-assistant.io/apps/guides/index.md): How to do things with apps, task by task. From the container image to publishing your repository.
- [App reference](https://contributors.home-assistant.io/apps/reference/index.md): The details you look up while building an app. Configuration keys, Bashio functions, files, the runtime environment, and the security rating.
- [Bashio](https://contributors.home-assistant.io/apps/bashio/index.md): The shell function library in the app base images. How to load it, what it changes in your script, and every function it has.
- [Supervisor API](https://contributors.home-assistant.io/apps/supervisor-api/index.md): The REST API the Supervisor offers to apps, how to authenticate, what your app is allowed to call, and what the responses look like.

## Marketplace

Publish integrations, cards, themes, and blueprints for others to install.

- [Marketplace](https://contributors.home-assistant.io/marketplace/index.md): Share what you build with everyone who runs Home Assistant. Publish custom integrations, dashboard cards, themes, template macros, and blueprints, and keep them up to date.
- [Share your first blueprint](https://contributors.home-assistant.io/marketplace/first-contribution/index.md): Turn an automation that already works in your home into a blueprint, import it yourself to test it, and share it on the Blueprint Exchange.
- [How the Marketplace works](https://contributors.home-assistant.io/marketplace/how-it-works/index.md): How the Marketplace finds your repository, checks it, installs it, and keeps it up to date, and how blueprints are shared and updated without it.
- [Marketplace guides](https://contributors.home-assistant.io/marketplace/guides/index.md): How to publish each kind of work, keep it up to date, and get it into the catalog.
- [Publish a custom integration](https://contributors.home-assistant.io/marketplace/guides/integrations/index.md): What is different when your integration lives in its own repository instead of in core, and what the Marketplace needs from it.
- [Publish a dashboard card or plugin](https://contributors.home-assistant.io/marketplace/guides/dashboard/index.md): Package a custom card, card feature, badge, or other JavaScript module so the Marketplace can install it and load it on every dashboard.
- [Publish a theme](https://contributors.home-assistant.io/marketplace/guides/themes/index.md): Write a theme file, choose the variables to set, support light and dark mode, test it, and package it for the Marketplace.
- [Publish template macros](https://contributors.home-assistant.io/marketplace/guides/templates/index.md): Share Jinja macros that others import into their templates, as one template file the Marketplace installs in custom_templates.
- [Write and share a blueprint](https://contributors.home-assistant.io/marketplace/guides/blueprints/index.md): Write a blueprint with good inputs and selectors, test it, change it without breaking what people built on it, and share it.
- [Releases and updates](https://contributors.home-assistant.io/marketplace/guides/releases/index.md): How users get your new versions through the Marketplace, how to publish pre-releases, and how to keep a release from reaching a Home Assistant that is too old for it.
- [Get into the catalog](https://contributors.home-assistant.io/marketplace/guides/catalog/index.md): Add your repository to the catalog that the Marketplace and HACS show to everyone, what the review checks, and how renames and removals work.
- [Marketplace reference](https://contributors.home-assistant.io/marketplace/reference/index.md): The details you look up. The hacs.json file, where your files go, and what is checked before an install.
- [hacs.json](https://contributors.home-assistant.io/marketplace/reference/hacs-json/index.md): Every key of the hacs.json file in the root of your repository, what HACS documents for it, and what the Marketplace does with it.
- [Repository structure](https://contributors.home-assistant.io/marketplace/reference/repository-structure/index.md): Where the files of each type go in your repository, what the Marketplace installs from it, and where that ends up in the user's configuration.
- [Validation checks](https://contributors.home-assistant.io/marketplace/reference/validation/index.md): The HACS action that checks your repository on every push, and the checks the Marketplace runs before it calls an install done.

The pages of this area: [Marketplace](https://contributors.home-assistant.io/marketplace/llms.txt). Their full text: [Marketplace, full text](https://contributors.home-assistant.io/marketplace/llms-full.txt).

## Companion apps

Android, iOS, and macOS.

This area has 37 pages. Below are its starting points. The pages of this area: [Companion apps](https://contributors.home-assistant.io/companion/llms.txt). Their full text: [Companion apps, full text](https://contributors.home-assistant.io/companion/llms-full.txt).

- [Companion apps](https://contributors.home-assistant.io/companion/index.md): The official Home Assistant apps for Android, iOS, iPadOS, macOS, watchOS, Wear OS, and the car. How they are built, and how to help build them.
- [Your first companion app contribution](https://contributors.home-assistant.io/companion/first-contribution/index.md): Pick Android or Apple, build the app on your machine, and open your first pull request.
- [Android](https://contributors.home-assistant.io/companion/android/index.md): The Home Assistant app for Android, Wear OS, Android Auto, and Android Automotive. What is in the repository, and where to start.
- [Apple](https://contributors.home-assistant.io/companion/apple/index.md): The Home Assistant app for iPhone, iPad, Mac, Apple Watch, and CarPlay. What is in the repository, and where to start.
- [Mobile app API](https://contributors.home-assistant.io/companion/mobile-app-api/index.md): How an app connects to Home Assistant through the mobile_app integration. Registration, the webhook, sensors, location, notifications, and the web view.

## OS and Supervisor

The operating system, boards, and updates.

- [OS and Supervisor](https://contributors.home-assistant.io/os/index.md): Work on Home Assistant OS and the Supervisor, the two pieces that turn a board or a virtual machine into a Home Assistant system that runs, updates, and repairs itself.
- [Your first contribution to the Supervisor](https://contributors.home-assistant.io/os/first-contribution/index.md): Run the Supervisor in its development container, make a small change, run the tests, and open your first pull request.
- [Installation types](https://contributors.home-assistant.io/os/installation-types/index.md): Where Home Assistant OS and the Supervisor are used, where they are not, and what that means for your code.
- [Home Assistant OS](https://contributors.home-assistant.io/os/operating-system/index.md): What Home Assistant OS is made of, how it boots, and how its repository is organized.
- [Build an image](https://contributors.home-assistant.io/os/operating-system/build/index.md): Set up the build container and build Home Assistant OS for a board.
- [Test your build](https://contributors.home-assistant.io/os/operating-system/test/index.md): Boot your image in QEMU, run the automated tests, and install your build on a real device.
- [Configure the host](https://contributors.home-assistant.io/os/operating-system/configuration/index.md): Change host settings on Home Assistant OS with a CONFIG USB drive, or directly in the persistent folders on the host.
- [Configure networking](https://contributors.home-assistant.io/os/operating-system/networking/index.md): How Home Assistant OS manages the network with NetworkManager, and how to configure what the UI does not cover.
- [Debug the host](https://contributors.home-assistant.io/os/operating-system/debugging/index.md): Get a root shell on Home Assistant OS over SSH or a console, and find the logs you need.
- [Releases and builds](https://contributors.home-assistant.io/os/operating-system/releases/index.md): How a change to Home Assistant OS goes from a pull request to a release, with the branches, version numbers, and build pipelines involved.
- [Partitions](https://contributors.home-assistant.io/os/operating-system/partitions/index.md): The disk layout of Home Assistant OS, what each partition holds, and how the data disk feature moves the data partition.
- [The update system](https://contributors.home-assistant.io/os/operating-system/update-system/index.md): How Home Assistant OS updates itself with RAUC and two boot slots, how bundles are signed, and how to install your own build.
- [Board metadata](https://contributors.home-assistant.io/os/operating-system/board-metadata/index.md): The variables in the meta file of every board, and the version file shared by all of them.
- [Supported boards](https://contributors.home-assistant.io/os/operating-system/boards/index.md): Every board Home Assistant OS builds for, with its build target, bootloader, and machine type.
- [Raspberry Pi](https://contributors.home-assistant.io/os/operating-system/raspberry-pi/index.md): Raspberry Pi specifics for Home Assistant OS, like the serial console, I2C, and booting from USB.
- [ODROID](https://contributors.home-assistant.io/os/operating-system/odroid/index.md): Hardkernel ODROID specifics for Home Assistant OS, like eMMC installation, the boot flow of the M1 and M1S, and the consoles.
- [Generic systems](https://contributors.home-assistant.io/os/operating-system/generic/index.md): The generic x86-64 and aarch64 targets, for PCs and other systems that boot with UEFI.
- [Virtual machines](https://contributors.home-assistant.io/os/operating-system/virtual-machine/index.md): The ova target, the virtual disk formats it builds, and what a virtual machine needs to run Home Assistant OS.
- [Supervisor](https://contributors.home-assistant.io/os/supervisor/index.md): What the Supervisor does, what it runs, and how it relates to apps and the Supervisor API.
- [Supervisor architecture](https://contributors.home-assistant.io/os/supervisor/architecture/index.md): How the Supervisor code is organized, how it starts, and how updates and backups work inside it.
- [Jobs](https://contributors.home-assistant.io/os/supervisor/jobs/index.md): How the Supervisor runs work as jobs, with conditions, concurrency limits, throttling, and progress that clients can follow.
- [The resolution center](https://contributors.home-assistant.io/os/supervisor/resolution-center/index.md): How the Supervisor finds problems with checks and evaluations, tracks them as issues, and fixes them with suggestions.
- [Plugins](https://contributors.home-assistant.io/os/supervisor/plugins/index.md): The five plugins the Supervisor runs next to Home Assistant Core, what each one does, and where its code lives.
- [Set up a development environment](https://contributors.home-assistant.io/os/supervisor/development/index.md): Run the Supervisor from source in its development container, run the tests and linters, and try your build on a real system.
- [Debug the Supervisor](https://contributors.home-assistant.io/os/supervisor/debugging/index.md): Attach a Python debugger to a running Supervisor, locally or on a remote device, and find its logs.
- [Connect Core to a Supervisor](https://contributors.home-assistant.io/os/supervisor/core-connection/index.md): Run Home Assistant Core from your development environment against a real Supervisor, to work on the hassio integration.

The pages of this area: [OS and Supervisor](https://contributors.home-assistant.io/os/llms.txt). Their full text: [OS and Supervisor, full text](https://contributors.home-assistant.io/os/llms-full.txt).

## Design

Foundations, components, patterns, and UI text.

This area has 107 pages. Below are its starting points. The pages of this area: [Design](https://contributors.home-assistant.io/design/llms.txt). Their full text: [Design, full text](https://contributors.home-assistant.io/design/llms-full.txt).

- [Design](https://contributors.home-assistant.io/design/index.md): The open design resource of Home Assistant. Principles, foundations, components, and patterns, for the designers and developers who build the interface together.
- [Your first design contribution](https://contributors.home-assistant.io/design/first-contribution/index.md): Find something to improve, design a better way, and share it. Here is how to get started.
- [How we design](https://contributors.home-assistant.io/design/how-we-design/index.md): Where design work happens, how an idea becomes part of Home Assistant, who decides, and how research shapes it.
- [Design principles](https://contributors.home-assistant.io/design/principles/index.md): The values behind every design decision. What the Open Home means for the interface, and how the personality of Home Assistant shows up in it.
- [Who we design for](https://contributors.home-assistant.io/design/users/index.md): The three types of users we keep in mind when making design decisions.
- [Foundations](https://contributors.home-assistant.io/design/foundations/index.md): Color, typography, spacing, motion, and accessibility. The design tokens and rules behind everything in Home Assistant.
- [Components](https://contributors.home-assistant.io/design/components/index.md): The building blocks of the Home Assistant interface, with guidelines, specs, accessibility, and code, on one page per component.
- [Patterns](https://contributors.home-assistant.io/design/patterns/index.md): Recurring situations in the Home Assistant interface, like a form, a wait, an empty list, or an error, and how the frontend handles them.
- [Dashboards](https://contributors.home-assistant.io/design/dashboards/index.md): What dashboards and cards are, how to pick the right card, and the principles every card follows.
- [More info](https://contributors.home-assistant.io/design/more-info/index.md): The dialog that opens when you select an entity, and the view each type of entity gets in it.
- [UI text](https://contributors.home-assistant.io/design/ui-text/index.md): How the interface talks. The voice, style, and words of Home Assistant, for everyone who writes a label, a button, or an error.

## Brand

Who Home Assistant is, how it sounds, and how to use its name and logo.

- [Brand](https://contributors.home-assistant.io/brand/index.md): Who Home Assistant is, how it sounds, and how to use its name and logo. For everyone who writes, designs, translates, or talks on behalf of the project.
- [Your first brand contribution](https://contributors.home-assistant.io/brand/first-contribution/index.md): Pick one page or one piece of interface text, read it against the personality of Home Assistant, and improve it.
- [Our story and values](https://contributors.home-assistant.io/brand/our-story/index.md): The Open Home, the three values behind every decision in Home Assistant, and where the project comes from.
- [Personality](https://contributors.home-assistant.io/brand/personality/index.md): The five traits that describe who Home Assistant is, what each of them means, and what each of them is not.
- [Voice and tone](https://contributors.home-assistant.io/brand/voice-and-tone/index.md): How the personality of Home Assistant sounds in documentation, the interface, error messages, community replies, release notes, and social media.
- [Name and logo](https://contributors.home-assistant.io/brand/name-and-logo/index.md): How to write the Home Assistant name, how to use the logo, and how both relate to the Open Home Foundation.

The pages of this area: [Brand](https://contributors.home-assistant.io/brand/llms.txt). Their full text: [Brand, full text](https://contributors.home-assistant.io/brand/llms-full.txt).

## Writing docs

The user documentation on home-assistant.io.

- [Writing docs](https://contributors.home-assistant.io/writing/index.md): Help millions of people get more out of Home Assistant, by improving the documentation on home-assistant.io.
- [Your first docs fix](https://contributors.home-assistant.io/writing/first-contribution/index.md): Fix something small in the documentation, straight from your browser. No setup needed.
- [How the documentation works](https://contributors.home-assistant.io/writing/how-it-works/index.md): Where the pages live, which branch to use, and how a change goes from pull request to home-assistant.io.
- [Writing guides](https://contributors.home-assistant.io/writing/guides/index.md): How to write and change the documentation, task by task. From structuring a page to moving one.
- [Structure a page](https://contributors.home-assistant.io/writing/guides/structure/index.md): Organize documentation around what the reader wants to know or do, with concepts, tasks, references, tutorials, and troubleshooting.
- [Preview the site locally](https://contributors.home-assistant.io/writing/guides/local-preview/index.md): Run home-assistant.io on your own machine, so you can see bigger changes before you share them.
- [Document an integration](https://contributors.home-assistant.io/writing/guides/integration/index.md): For developers adding a new integration to Home Assistant. What the documentation needs, and how to get it merged together with your code.
- [Move, rename, or remove a page](https://contributors.home-assistant.io/writing/guides/move-or-remove/index.md): Pages get linked from everywhere. Here is how to change them without breaking those links.
- [Writing reference](https://contributors.home-assistant.io/writing/reference/index.md): The details you look up while writing. Style, images, Liquid, YAML, the automated checks, and integration pages.
- [Documentation style guide](https://contributors.home-assistant.io/writing/reference/style/index.md): The language, tone, and Markdown formatting rules for every page on home-assistant.io.
- [Images and videos](https://contributors.home-assistant.io/writing/reference/images/index.md): How to add screenshots, diagrams, and YouTube videos to a page on home-assistant.io, and how to describe them for every reader.
- [Liquid helpers](https://contributors.home-assistant.io/writing/reference/liquid/index.md): Every Liquid tag home-assistant.io adds on top of Markdown, from My links and glossary tooltips to text boxes and reusable snippets.
- [YAML style](https://contributors.home-assistant.io/writing/reference/yaml/index.md): How YAML examples in the documentation should look, so they are easy to read, copy, and adapt.
- [Automated documentation checks](https://contributors.home-assistant.io/writing/reference/checks/index.md): What the automated checks on your documentation pull request look for, how to run them yourself, and how to change them.
- [Integration front matter](https://contributors.home-assistant.io/writing/reference/front-matter/index.md): Every key you can use at the top of an integration page, what it does, and which values it accepts.
- [Integration page structure](https://contributors.home-assistant.io/writing/reference/integration-page/index.md): The sections of an integration page in order, and the blocks and reusable text you use to fill them.
- [Improve this contributor site](https://contributors.home-assistant.io/writing/this-site/index.md): Fix or add a page on contributors.home-assistant.io, preview it on your own machine, and keep links and redirects working.

The pages of this area: [Writing docs](https://contributors.home-assistant.io/writing/llms.txt). Their full text: [Writing docs, full text](https://contributors.home-assistant.io/writing/llms-full.txt).

## Translations

Bring Home Assistant to your language.

- [Translations](https://contributors.home-assistant.io/translate/index.md): Bring Home Assistant to your language. No coding needed, just a good feel for your own language.
- [Your first translation](https://contributors.home-assistant.io/translate/first-contribution/index.md): Join a translation project, find your language, and translate your first strings. It takes about fifteen minutes.
- [How translation works](https://contributors.home-assistant.io/translate/how-it-works/index.md): Where the strings come from, where they get translated, and how they end up in Home Assistant.
- [Translation guides](https://contributors.home-assistant.io/translate/guides/index.md): How to handle the trickier parts of translating, task by task. Placeholders, new languages, and translatable strings.
- [Placeholders and references](https://contributors.home-assistant.io/translate/guides/placeholders/index.md): The parts of a string you should not translate, and how to handle them.
- [Request a new language](https://contributors.home-assistant.io/translate/guides/new-language/index.md): Your language is not available yet? Here is how to get it added.
- [Make your strings translatable](https://contributors.home-assistant.io/translate/guides/developers/index.md): For developers adding text to Home Assistant. How to write strings that translators can work with.
- [Translation reference](https://contributors.home-assistant.io/translate/reference/index.md): The rules for every language, and the agreements made per language.
- [Translation rules](https://contributors.home-assistant.io/translate/reference/rules/index.md): The rules that apply to every language. Short, and worth reading before you start.
- [Language guidelines](https://contributors.home-assistant.io/translate/reference/languages/index.md): Agreements made per language, like formal or informal address. Written in the language they are about.
- [Voice](https://contributors.home-assistant.io/translate/voice/index.md): Teach Assist your language. Write the sentences it understands and the answers it gives, and help train the voices behind it.
- [How Assist understands language](https://contributors.home-assistant.io/translate/voice/how-assist-understands/index.md): Intents, sentences, slots, lists, and responses. The ideas behind Assist, and how a spoken command becomes an action.
- [Contribute sentences and responses](https://contributors.home-assistant.io/translate/voice/contributing/index.md): How to change the sentences, responses, and tests of your language in the intents repository, check your work, and open a pull request.
- [Voice style guide](https://contributors.home-assistant.io/translate/voice/style-guide/index.md): How to write sentences that match the way people talk, and responses that are short and clear.
- [Supported languages](https://contributors.home-assistant.io/translate/voice/languages/index.md): The languages Assist understands with the built-in conversation agent, their leaders, and how to add a new language.
- [Language leaders](https://contributors.home-assistant.io/translate/voice/language-leaders/index.md): Every language in the intents repository has leaders who review its changes. What the role involves, and how to become one.
- [Contribute your voice](https://contributors.home-assistant.io/translate/voice/contributing-your-voice/index.md): Help the open voice community build speech recognition and voices for your language, by recording or reviewing speech.
- [Template sentence syntax](https://contributors.home-assistant.io/translate/voice/template-syntax/index.md): The complete reference for sentence files, the template syntax, lists, expansion rules, responses, and the common file of a language.
- [Test syntax](https://contributors.home-assistant.io/translate/voice/test-syntax/index.md): How to write the tests that prove your sentences match the right intent, fill the right slots, and give the right response.
- [Built-in intents](https://contributors.home-assistant.io/translate/voice/intents/index.md): Every intent Home Assistant understands out of the box, with its slots, its slot combinations, and the integration that handles it.

The pages of this area: [Translations](https://contributors.home-assistant.io/translate/llms.txt). Their full text: [Translations, full text](https://contributors.home-assistant.io/translate/llms-full.txt).

## Community

Moderation, social media, and events.

- [Community](https://contributors.home-assistant.io/community/index.md): Help people, keep the conversation friendly, and bring smart home fans together, online and in person.
- [Your first community contribution](https://contributors.home-assistant.io/community/first-contribution/index.md): Answer one question on the community forum. It takes about fifteen minutes, and you know more than you think.
- [Community guides](https://contributors.home-assistant.io/community/guides/index.md): How to help the community, task by task. From welcoming newcomers to hosting a meetup.
- [Welcome newcomers](https://contributors.home-assistant.io/community/guides/welcome-newcomers/index.md): How to help someone who just installed Home Assistant feel at home, and find their own way.
- [How moderation works](https://contributors.home-assistant.io/community/guides/moderation/index.md): What moderators do, the guidelines they apply, and the steps they take when someone breaks the rules.
- [Report a problem](https://contributors.home-assistant.io/community/guides/reporting/index.md): What to do when someone breaks the code of conduct, or when you or someone else does not feel safe.
- [Host a meetup](https://contributors.home-assistant.io/community/guides/meetups/index.md): Bring smart home fans in your city together. Create the event, get it listed, and get your costs covered.
- [Help on social media](https://contributors.home-assistant.io/community/guides/social-media/index.md): How you can help Home Assistant reach more people on social media, and who to contact.
- [Community reference](https://contributors.home-assistant.io/community/reference/index.md): The places where the community meets, and the programs that support it.
- [Where the community lives](https://contributors.home-assistant.io/community/reference/channels/index.md): The official places where the Home Assistant community meets, and what each one is for.
- [Programs](https://contributors.home-assistant.io/community/reference/programs/index.md): The Creator Network for content creators, and Works with Home Assistant for device makers.
- [Events and calendar](https://contributors.home-assistant.io/community/reference/events/index.md): The release dates, community syncs, meetups, and Community Day coming up, and how to add them to your own calendar.

The pages of this area: [Community](https://contributors.home-assistant.io/community/llms.txt). Their full text: [Community, full text](https://contributors.home-assistant.io/community/llms-full.txt).

## Releases

Try the beta, report what breaks, and see how a release comes together.

- [Releases](https://contributors.home-assistant.io/releases/index.md): How a new version of Home Assistant comes together every month, and how you can help test it, explain it, and ship it.
- [Your first beta test](https://contributors.home-assistant.io/releases/first-contribution/index.md): Join the beta, run the next release a week before everyone else, and report what breaks.
- [How releases work](https://contributors.home-assistant.io/releases/how-it-works/index.md): The monthly release cycle of Home Assistant, from the first line of code to the last patch release.
- [Release guides](https://contributors.home-assistant.io/releases/guides/index.md): How to help a release come together, task by task. From the release notes to getting a fix into a patch release.
- [Release notes and the release party](https://contributors.home-assistant.io/releases/guides/release-notes/index.md): How the monthly release notes come together, how you can help make them better, and what the release party is.
- [Document a backward-incompatible change](https://contributors.home-assistant.io/releases/guides/backward-incompatible-changes/index.md): When your change means users have to do something, tell them what breaks, how to fix it, and why. That text ends up in the release notes.
- [Deprecate something](https://contributors.home-assistant.io/releases/guides/deprecations/index.md): The deprecation policy of Home Assistant, what it means for the people who use it, and how deprecations show up in the release notes.
- [Get a fix into a patch release](https://contributors.home-assistant.io/releases/guides/patch-releases/index.md): How a bug fix reaches the beta and the patch releases, and what you can do to help it get there.
- [Release reference](https://contributors.home-assistant.io/releases/reference/index.md): The details you look up. Version numbers, release channels, and who does what in a release.
- [Versions and channels](https://contributors.home-assistant.io/releases/reference/versions/index.md): What a Home Assistant version number means, and the stable, beta, and dev channels.
- [Who does what](https://contributors.home-assistant.io/releases/reference/roles/index.md): The people involved in a Home Assistant release, and what each of them does.

The pages of this area: [Releases](https://contributors.home-assistant.io/releases/llms.txt). Their full text: [Releases, full text](https://contributors.home-assistant.io/releases/llms-full.txt).

## Roadmap

How ideas become planned work, and where you can help shape what comes next.

- [Roadmap](https://contributors.home-assistant.io/roadmap/index.md): How ideas become planned work at the Open Home Foundation, what is being worked on, and where you can help shape what comes next.
- [Your first roadmap contribution](https://contributors.home-assistant.io/roadmap/first-contribution/index.md): Share a feature request, or add your use case to an existing one. That is how ideas reach the roadmap.
- [From idea to release](https://contributors.home-assistant.io/roadmap/how-it-works/index.md): How larger work on Home Assistant is planned in the open, from a feature request to a roadmap opportunity, an epic, tasks, and pull requests, and where you can join in along the way.

The pages of this area: [Roadmap](https://contributors.home-assistant.io/roadmap/llms.txt). Their full text: [Roadmap, full text](https://contributors.home-assistant.io/roadmap/llms-full.txt).

## Architecture

How everything fits together, and the decisions behind it.

- [Architecture](https://contributors.home-assistant.io/architecture/index.md): How everything fits together, and the decisions behind it.
- [The big picture](https://contributors.home-assistant.io/architecture/big-picture/index.md): All the pieces of Home Assistant on one page, what each one does, and how they talk to each other.
- [Architecture principles](https://contributors.home-assistant.io/architecture/principles/index.md): The ideas behind how Home Assistant is built. Once you know them, many rules in code review stop being surprising.
- [How architecture decisions are made](https://contributors.home-assistant.io/architecture/decisions/index.md): Where architecture is discussed, how a decision gets recorded, and how you can take part.
- [Repositories](https://contributors.home-assistant.io/architecture/repositories/index.md): Where the code of Home Assistant lives on GitHub, and which repository to go to for what.
- [Inside Home Assistant Core](https://contributors.home-assistant.io/architecture/core/index.md): A tour of the Python application at the heart of Home Assistant, with the way to the details of every part.
- [From start to running](https://contributors.home-assistant.io/architecture/core/startup/index.md): What Home Assistant Core does between the moment it starts and the moment your home is ready, and how it shuts down again.
- [Getting data](https://contributors.home-assistant.io/architecture/core/data-updates/index.md): How integrations get new data from devices and services, by push or by polling, and how a coordinator keeps that efficient.
- [Registries and storage](https://contributors.home-assistant.io/architecture/core/registries/index.md): Where Home Assistant keeps what it knows about entities, devices, and areas, how users' changes are kept apart from what integrations report, and how data is stored.
- [History and statistics](https://contributors.home-assistant.io/architecture/core/history/index.md): How the recorder writes every state change to a database, and how history, the logbook, and long-term statistics read it back.
- [How the pieces talk](https://contributors.home-assistant.io/architecture/connections/index.md): The APIs between Home Assistant Core and everything around it, and how everyone who connects proves who they are.
- [The frontend](https://contributors.home-assistant.io/architecture/frontend/index.md): Where the web interface fits in the whole of Home Assistant, and where to find its details.
- [How dashboards work](https://contributors.home-assistant.io/architecture/frontend/dashboards/index.md): How dashboards are put together from views, sections, cards, and badges, how strategies generate them, and how custom cards fit in.
- [Around Core](https://contributors.home-assistant.io/architecture/platform/index.md): The software that runs next to Home Assistant Core, or talks to it from elsewhere, and how it all fits together.
- [The Supervisor](https://contributors.home-assistant.io/architecture/platform/supervisor/index.md): The program that runs Home Assistant Core, apps, backups, and updates on Home Assistant OS, each in its own container.
- [How the companion apps fit in](https://contributors.home-assistant.io/architecture/platform/companion-apps/index.md): Home Assistant on Android and Apple devices: the frontend in an app, plus sensors, notifications, widgets, and more from the device itself.
- [Home Assistant Link](https://contributors.home-assistant.io/architecture/platform/cloud/index.md): How Home Assistant Link makes a home reachable from anywhere, and connects it to voice assistants, without opening it to the internet.
- [How voice works](https://contributors.home-assistant.io/architecture/platform/voice/index.md): How a spoken sentence becomes an action: wake word, speech-to-text, a conversation agent, and text-to-speech, and where each runs.

The pages of this area: [Architecture](https://contributors.home-assistant.io/architecture/llms.txt). Their full text: [Architecture, full text](https://contributors.home-assistant.io/architecture/llms-full.txt).

## Security

Report a vulnerability, and build software that protects the homes it runs in.

- [Security](https://contributors.home-assistant.io/security/index.md): Report a vulnerability, and build software that protects the homes it runs in.
- [Your first security contribution](https://contributors.home-assistant.io/security/first-contribution/index.md): Check the diagnostics of an integration you use for data that should not be in there, and fix what you find.
- [How Home Assistant handles trust](https://contributors.home-assistant.io/security/how-it-works/index.md): Who Home Assistant trusts, where it can be attacked, and what the system already does to protect the homes it runs in.
- [Report a vulnerability](https://contributors.home-assistant.io/security/report-a-vulnerability/index.md): How to report a security vulnerability in Home Assistant privately, what qualifies, and what happens after you report.
- [Security guides](https://contributors.home-assistant.io/security/guides/index.md): How to keep the code you write or review safe, per kind of contribution.
- [Secure integrations](https://contributors.home-assistant.io/security/guides/integrations/index.md): Credentials, certificates, redaction, admin-only access, webhooks, and file paths. The patterns and helpers that keep an integration safe.
- [Untrusted content in the frontend](https://contributors.home-assistant.io/security/guides/frontend/index.md): Entity names, attributes, Markdown, and URLs can come from anywhere. How the frontend escapes, sanitizes, and checks them, and what you need to do.
- [Secure apps](https://contributors.home-assistant.io/security/guides/apps/index.md): What the advisories about apps and the Supervisor teach, on top of the security guide of the apps area.
- [Secure companion apps](https://contributors.home-assistant.io/security/guides/companion-apps/index.md): What the advisories of the Android and iOS apps teach about links, exported components, the WebView, and the JavaScript bridge.
- [Dependencies and supply chain](https://contributors.home-assistant.io/security/guides/dependencies/index.md): Every library Home Assistant installs runs inside it. What Home Assistant asks of a dependency, what it checks automatically, and how its own workflows are protected.
- [Review with security in mind](https://contributors.home-assistant.io/security/guides/reviewing/index.md): What to look for in a pull request so security problems do not reach people's homes, and what to do when you find one.
- [Security reference](https://contributors.home-assistant.io/security/reference/index.md): The details you look up. Security helpers, the automated checks, and every past advisory.
- [Security helpers](https://contributors.home-assistant.io/security/reference/helpers/index.md): The helpers of Home Assistant Core and the frontend that handle certificates, redaction, admin access, webhooks, paths, and untrusted content.
- [Automated security checks](https://contributors.home-assistant.io/security/reference/checks/index.md): The tools that check the code, dependencies, and workflows of Home Assistant for security problems, and where they run.
- [Past advisories](https://contributors.home-assistant.io/security/reference/advisories/index.md): Every published security advisory of Home Assistant, grouped by kind, with what went wrong and the lesson for contributors.

The pages of this area: [Security](https://contributors.home-assistant.io/security/llms.txt). Their full text: [Security, full text](https://contributors.home-assistant.io/security/llms-full.txt).

## Data

Analytics and open data sets.

- [Data](https://contributors.home-assistant.io/data/index.md): What Home Assistant learns from data, how it respects your privacy while doing so, and how to explore the data of your own home.
- [Your first data contribution](https://contributors.home-assistant.io/data/first-contribution/index.md): Share analytics from your installation, check exactly what it sends, and see your installation counted. It takes a few minutes and one restart.
- [How analytics works](https://contributors.home-assistant.io/data/how-it-works/index.md): The path your analytics take, from your installation to the public analytics site, and how the device database fits in.
- [Privacy principles](https://contributors.home-assistant.io/data/privacy/index.md): The rules Home Assistant follows for every bit of data it collects, and why.
- [Data guides](https://contributors.home-assistant.io/data/guides/index.md): How to work with Home Assistant data, task by task. From the public data sets to analytics in your integration.
- [Use the public data](https://contributors.home-assistant.io/data/guides/public-data/index.md): Download the analytics data sets as JSON, or scrape them with Prometheus, and build your own charts.
- [Explore your own data](https://contributors.home-assistant.io/data/guides/explore-your-data/index.md): Set up JupyterLab, connect it to the database of your Home Assistant, and run your first report. About fifteen minutes.
- [Query the database](https://contributors.home-assistant.io/data/guides/query-the-database/index.md): Example SQL queries to read states, events, and context from the Home Assistant database, for SQLite, MariaDB, and PostgreSQL.
- [Analytics in your integration](https://contributors.home-assistant.io/data/guides/integration-analytics/index.md): For developers, how your integration shows up in analytics, and how to keep devices or entities out of the device database.
- [Data reference](https://contributors.home-assistant.io/data/reference/index.md): The details you look up. What analytics shares, the data model, the database schema, and statistics.
- [What analytics shares](https://contributors.home-assistant.io/data/reference/analytics-data/index.md): Every field Home Assistant sends when you turn on analytics, per option, with example data.
- [The data model](https://contributors.home-assistant.io/data/reference/data-model/index.md): Events, states, context, and actions, the building blocks of everything Home Assistant records.
- [Database schema](https://contributors.home-assistant.io/data/reference/database-schema/index.md): The tables of the recorder database, what is in them, and how they connect.
- [Statistics](https://contributors.home-assistant.io/data/reference/statistics/index.md): How Home Assistant summarizes sensor data into 5-minute and hourly statistics, and how those are stored.

The pages of this area: [Data](https://contributors.home-assistant.io/data/llms.txt). Their full text: [Data, full text](https://contributors.home-assistant.io/data/llms-full.txt).

## Optional

- [Blog](https://contributors.home-assistant.io/blog/): News for everyone who contributes to Home Assistant. The feed is at https://contributors.home-assistant.io/blog/rss.xml.
- [Glossary](https://contributors.home-assistant.io/glossary/index.md): One term, one meaning. Shared by code, UI text, and docs.
- [Glossary, every page](https://contributors.home-assistant.io/glossary/llms.txt): Every page of the glossary, with its description.
- [Glossary, full text](https://contributors.home-assistant.io/glossary/llms-full.txt): The full text of every page of the glossary.