20220330.0 (home-assistant#12165)

* Add a docs icon to the config flow dialog

* Use same help icon everywhere

* Fix quickbar overlaying, fix click handling (home-assistant#11900)

* Supervisor mobile click accessibility (home-assistant#11915)

* Convert objects to string in config flow error (home-assistant#11908)

* Fix datepicker triangle (home-assistant#11920)

* Always show tab labels (home-assistant#11919)

* Remove zwave and ozw panels (home-assistant#11911)

Remove zwave and ozw panels

* Convert lovelace config dialogs to ha-form (home-assistant#11910)

* Guard setting up config flow for an unsupported domain (home-assistant#11937)

* Show triggered vars on click (home-assistant#11924)

* Allow marking YAML editor as read only (home-assistant#11960)

* Convert inputs (home-assistant#11907)

* Convert inputs

* Update dialog-thingtalk.ts

* imports

* Remove some additional old zwave code (home-assistant#11941)

* Correct media upload error + add file name (home-assistant#11949)

Co-authored-by: Bram Kragten <[email protected]>

* Fix humidifier more info mode dropdown (home-assistant#11964)

* Make min width of select configurable (home-assistant#11965)

* Fix for Statistics Editor (home-assistant#11942)

Co-authored-by: Bram Kragten <[email protected]>

* A11y expansion panel (home-assistant#11967)

* Convert file upload to mdc (home-assistant#11906)

* Add location selector, convert zone editor (home-assistant#11902)

* Add systemd_resolved unsupported reason (home-assistant#11971)

* replace default switch icon 

to  make it stand out against a power entity which uses the same mdiFlash home-assistant/core#67620 (comment)

suggest the Outline version, so create a subtle difference with the on/off icons.

* Allow selecting multiple entities (home-assistant#11986)

* Fix theme setting (home-assistant#11977)

* Update Style of Design Page (home-assistant#11982)

* change icon to mimic physical device

and follow comments

* Use entities-picker in entity selector (home-assistant#11990)

* home-assistant#11971 Change order of alarm panel buttons (home-assistant#11998)

* Fix zwave_js 'add/remove device' disabled bug (home-assistant#12000)

* Fix zwave_js 'add/remove device' disabled bug

* revert extra change

* Fix zwave_js set config dropdown default value (home-assistant#11974)

Co-authored-by: Paulus Schoutsen <[email protected]>

* Fix changing cost number in energy settings (home-assistant#12009)

* Fix Dashboard Editing (home-assistant#12011)

* Fix For Selecting Device Class (home-assistant#12010)

* Fix: Allow for deleting Input_select options (home-assistant#12007)

* Script ID update with Alias (home-assistant#12008)

* HAWS 6.1 (home-assistant#12016)

* Bumped version to 20220301.1

* Bumped version to 20220301.2

* Bumped version to 20220312.0

* Add shade to device class overrides (home-assistant#11874)

* Fix: Changing Blueprint Automation Name (home-assistant#12036)

* Fix @Changed where using ev.detail (home-assistant#12043)

* Add all cover device classes (home-assistant#12042)

* Rename Lovelace Dashboard to just Dashboard (home-assistant#12044)

Co-authored-by: Zack Barett <[email protected]>

* Add Color Temp Selector (home-assistant#12041)

* Utilize Hide Hidden Entities

* Reviews

* add to demo

* Add `Brand` folder and `Our story` page (home-assistant#11978)

Co-authored-by: Zack Barett <[email protected]>

* Add HA to public folder and show in markdown

* Update Translations

* Disabled by

* remove 1

* Add Description of chosen

* Add icons and buttons

* Add Color RGB Selector (home-assistant#12039)

* Add Date Selector

* Add ha-form context (home-assistant#12062)

* test condition (home-assistant#11925)

* Revamp URL form (home-assistant#12060)

* Add support for menu data entry flow option (home-assistant#12055)

* Add translation

* add to basic editor and update advanced style

* clean up

* Entity Status

* Add Devices Picker (home-assistant#12056)

* Remvoe redunency

* Bumped version to 20220316.0

* Bump HAWS to 7.0.0 (home-assistant#12067)

* Create new Logo page

* Add files via upload

* Ignore diagnostics not found exceptions (home-assistant#12066)

* Bump HAWS to 7.0.1

* Update lock

* Add Date Time Selector (home-assistant#12070)

* Add radio Form Logic to Select Selector (home-assistant#12063)

* Bumped version to 20220317.0 (home-assistant#12074)

* Update gallery/src/pages/brand/logo.markdown

Co-authored-by: Zack Barett <[email protected]>

* Update gallery/src/pages/brand/logo.markdown

Co-authored-by: Zack Barett <[email protected]>

* Update logo.markdown

* Fetch history with `no_attributes` for entities that do not need them (home-assistant#12082)

* Update required version of MDI to 6.6.95

* Upload release assets (home-assistant#11566)

Co-authored-by: Joakim Sørensen <[email protected]>

* Update styles for hui-editor

Update the background-color and text-color of the app-toolbar in
hui-editor to match the styles of hui-root while in edit-mode.

Previously, these properties were set using undefined css variables that
could not be changed via themes (--dark-background-color and
--dark-text-color).

* Fix gas energy graph units if stats added by external source (home-assistant#11892)

* Change Netlify preview URL (home-assistant#12095)

* Update src/dialogs/config-flow/dialog-data-entry-flow.ts

* Stack Action Inputs in the Button Editor (home-assistant#12076)

* Stack Action Inputs in the Button Editor

* update style

* Update for other editors

* Add support for update entities (home-assistant#12059)

* Add support for update entities

* Apply suggestions from code review

Co-authored-by: Zack Barett <[email protected]>

* Add to gallery

* implement xx%

* Adjustments for skipped

* Add progress bar

* Add UPDATE_SUPPORT_INSTALL

* Allow skipping without install support

* Add version to service call if supported

* Adjust changelog link

* Use Installing

* adjustments

* Use unavailable

Co-authored-by: Zack Barett <[email protected]>

* Add support for integration type (home-assistant#12077)

* Update When entity can change enabled or hidden (home-assistant#12096)

* Add entity include and exclude to selector (home-assistant#12078)

Co-authored-by: Paulus Schoutsen <[email protected]>

* change from hidden to not shown (home-assistant#12097)

* Add statistic adjust dialog (home-assistant#12101)

Co-authored-by: Zack Barett <[email protected]>

* Fix Duration Selector Default (home-assistant#12098)

* Fix Duration Default

* USe initial form data function

* Bumped version to 20220322.0 (home-assistant#12102)

* Create user types page and rename the category (home-assistant#12089)

Co-authored-by: Zack Barett <[email protected]>
Co-authored-by: Paulus Schoutsen <[email protected]>

* Remove `setup.py` (home-assistant#11593)

* Fix selecting 0 with number selector

* Update lock file with MDI updates

* Use update entities for showing updates on configuration panel (home-assistant#12100)

Co-authored-by: Paulus Schoutsen <[email protected]>

* Fix loading traces for automation with custom id (home-assistant#12112)

* Only show docs link when showing a form

* Exclude restored automations from dashboard (home-assistant#12113)

* Support descriptions in flow menu steps (home-assistant#12108)

Co-authored-by: Paulus Schoutsen <[email protected]>

* Sort selectors (home-assistant#12120)

* Update type for backend (home-assistant#12122)

* Fix issue where theme select does not appear when user's theme is deleted (home-assistant#12104)

* Fix possibility to enable entity disabled by integration (home-assistant#12121)

Co-authored-by: Zack Barett <[email protected]>

* Allow rendering helper text from strings.json (home-assistant#12119)

* Allow rendering helper text from strings.json

* Persistent helpers

* Update src/components/ha-base-time-input.ts

Co-authored-by: Zack Barett <[email protected]>

* Update src/components/ha-base-time-input.ts

Co-authored-by: Zack Barett <[email protected]>

* Add Day to duration selector (home-assistant#12125)

* Add variables to automation trigger type

* Fix z-index map, always set icon for location selector (home-assistant#12137)

* Make padding on settings row content consistent (home-assistant#12139)

* Add Area Multiple Selector option (home-assistant#12138)

* break theme picker out of lovelace (home-assistant#12140)

* Allow binary sensor device class updates (home-assistant#12124)

* Add selector initial values (home-assistant#12142)

* Add badge to configuration sidebar to indicate pending updates (home-assistant#12146)

* Bumped version to 20220329.0 (home-assistant#12152)

* Add entity source API (home-assistant#12149)

* Update adjust statistic dialog (home-assistant#12118)

* Update text for adjust statistic dialog

* Change everything

* Import type

* Max show 5

* Revert back the API change

* Hide adjust button if no sum

* Adjustments

* Update src/panels/developer-tools/statistics/developer-tools-statistics.ts

* Render optional

Co-authored-by: Zack <[email protected]>

* Fetch release notes for update entities that provides it (home-assistant#12148)

* Fetch release notes for update entities that provides it

* lint

* Add support for new timer properties (home-assistant#11940)

* Fix theme settings on design page (home-assistant#12154)

* Allow ha-alert to be used in our markdown render (home-assistant#12153)

* Allow device_tracker entities to use state_color (home-assistant#12127)

* Automation description text overflow (home-assistant#12040)

Co-authored-by: Bram Kragten <[email protected]>

* Update Pickers and selectors with required (home-assistant#12151)

* Update Pickers and selectors with required

* Use native * for device and entity

* Add support for my links to create a helper config entry (home-assistant#12155)

* Use brand icon instead of domain icon for helpers (home-assistant#12157)

* Import components that are allowed to be defined in markdown (home-assistant#12158)

* Add options to selectors gallery (home-assistant#12156)

* Add helpers to list when searching in add integration (home-assistant#12159)

* List Selector (home-assistant#12099)

Co-authored-by: Bram Kragten <[email protected]>

* Add shuffle and repeat-mode of media_player to UI (home-assistant#12052)

Co-authored-by: Paulus Schoutsen <[email protected]>

* Add panel to Backup integration (home-assistant#11671)

Co-authored-by: Zack Barett <[email protected]>
Co-authored-by: Paulus Schoutsen <[email protected]>

* Fix for Mobile View of Entities Table (home-assistant#12160)

* Allow Sensor Units to be updated via Entity Registry (home-assistant#12143)

* Add switch as x to entity settings (home-assistant#12161)

Co-authored-by: Zack <[email protected]>

* Bumped version to 20220330.0 (home-assistant#12164)

Co-authored-by: Paulus Schoutsen <[email protected]>
Co-authored-by: Bram Kragten <[email protected]>
Co-authored-by: Steve Repsher <[email protected]>
Co-authored-by: Robin Wittebol <[email protected]>
Co-authored-by: Raman Gupta <[email protected]>
Co-authored-by: Philip Allgaier <[email protected]>
Co-authored-by: Joakim Sørensen <[email protected]>
Co-authored-by: Marius <[email protected]>
Co-authored-by: Emil Stjerneman <[email protected]>
Co-authored-by: Charles Garwood <[email protected]>
Co-authored-by: Paulus Schoutsen <[email protected]>
Co-authored-by: jpearl <[email protected]>
Co-authored-by: Matthias de Baat <[email protected]>
Co-authored-by: Matthias de Baat <[email protected]>
Co-authored-by: J. Nick Koston <[email protected]>
Co-authored-by: Michael Irigoyen <[email protected]>
Co-authored-by: Marc Mueller <[email protected]>
Co-authored-by: Joakim Sørensen <[email protected]>
Co-authored-by: Nick Iacullo <[email protected]>
Co-authored-by: Pawel <[email protected]>
Co-authored-by: Erik <[email protected]>
Co-authored-by: Brynley McDonald <[email protected]>
Co-authored-by: blair <[email protected]>
Co-authored-by: NachtaktiverHalbaffe <[email protected]>

.github/workflows/release.yaml

@@ -10,10 +10,18 @@ env:
   NODE_VERSION: 14
   NODE_OPTIONS: --max_old_space_size=6144
 
+# Set default workflow permissions
+# All scopes not mentioned here are set to no access
+# https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token
+permissions:
+  actions: none
+
 jobs:
   release:
     name: Release
     runs-on: ubuntu-latest
+    permissions:
+      contents: write  # Required to upload release assets
     steps:
       - name: Checkout the repository
         uses: actions/checkout@v2
@@ -47,6 +55,13 @@ jobs:
 
           script/release
 
+      - name: Upload release assets
+        uses: softprops/[email protected]
+        with:
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+
   wheels-init:
     name: Init wheels build
     needs: release

cast/src/receiver/second-load.ts

@@ -1,4 +1,3 @@
-import "web-animations-js/web-animations-next-lite.min";
 import "../../../src/resources/ha-style";
 import "../../../src/resources/roboto";
 import "./layout/hc-lovelace";

gallery/script/netlify_build_gallery

@@ -23,7 +23,7 @@ if [[ "${PULL_REQUEST}" == "true" ]]; then
     createStatus "pending" "Building design preview" "https://app.netlify.com/sites/home-assistant-gallery/deploys/$BUILD_ID"
     gulp build-gallery
     if [ $? -eq 0 ]; then
-      createStatus "success" "Build complete" "$DEPLOY_URL"
+      createStatus "success" "Build complete" "$DEPLOY_PRIME_URL"
     else
       createStatus "error" "Build failed" "https://app.netlify.com/sites/home-assistant-gallery/deploys/$BUILD_ID"
     fi

gallery/sidebar.js

@@ -36,12 +36,17 @@ module.exports = [
     category: "misc",
     header: "Miscelaneous",
   },
+  {
+    category: "brand",
+    header: "Brand",
+  },
   {
     category: "user-test",
-    header: "User Tests",
+    header: "Users",
+    pages: ["user-types", "configuration-menu"],
   },
   {
     category: "design.home-assistant.io",
-    header: "Design Documentation",
+    header: "About",
   },
 ];

gallery/src/components/demo-black-white-row.ts

@@ -53,13 +53,19 @@ class DemoBlackWhiteRow extends LitElement {
 
   firstUpdated(changedProps) {
     super.firstUpdated(changedProps);
-    applyThemesOnElement(this.shadowRoot!.querySelector(".dark"), {
-      default_theme: "default",
-      default_dark_theme: "default",
-      themes: {},
-      darkMode: true,
-      theme: "default",
-    });
+    applyThemesOnElement(
+      this.shadowRoot!.querySelector(".dark"),
+      {
+        default_theme: "default",
+        default_dark_theme: "default",
+        themes: {},
+        darkMode: true,
+        theme: "default",
+      },
+      undefined,
+      undefined,
+      true
+    );
   }
 
   handleSubmit(ev) {

gallery/src/components/page-description.ts

@@ -12,7 +12,14 @@ class PageDescription extends HaMarkdown {
     if (!PAGES[this.page].description) {
       return html``;
     }
+
     return html`
+      <div class="heading">
+        <div class="title">
+          ${PAGES[this.page].metadata.title || this.page.split("/")[1]}
+        </div>
+        <div class="subtitle">${PAGES[this.page].metadata.subtitle}</div>
+      </div>
       ${until(
         PAGES[this.page]
           .description()
@@ -25,9 +32,22 @@ class PageDescription extends HaMarkdown {
   static styles = [
     HaMarkdown.styles,
     css`
+      .heading {
+        padding: 16px;
+        border-bottom: 1px solid var(--secondary-background-color);
+      }
+      .title {
+        font-size: 42px;
+        line-height: 56px;
+        padding-bottom: 8px;
+      }
+      .subtitle {
+        font-size: 18px;
+        line-height: 24px;
+      }
       .root {
         max-width: 800px;
-        margin: 0 auto;
+        margin: 16px auto;
       }
       .root > *:first-child {
         margin-top: 0;

gallery/src/data/text.ts

@@ -0,0 +1,11 @@
+export const LONG_TEXT = `
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc laoreet velit ut elit volutpat, eget ultrices odio lacinia. In imperdiet malesuada est, nec sagittis metus ultricies quis. Sed nisl ex, convallis porttitor ante quis, hendrerit tristique justo. Mauris pharetra venenatis augue, eu maximus sem cursus in. Quisque sed consequat risus. Suspendisse facilisis ligula a odio consectetur condimentum. Curabitur vehicula elit nec augue mollis, et volutpat massa dictum.
+
+Nam pellentesque auctor rutrum. Suspendisse elit est, sodales vel diam nec, porttitor faucibus massa. Ut pretium ac orci eu pharetra. Praesent in nibh at magna viverra rutrum eu vitae tortor. Etiam eget sem ex. Fusce tristique odio nec lacus mattis, vitae tempor nunc malesuada. Maecenas faucibus magna vel libero maximus egestas. Vestibulum luctus semper velit, in lobortis risus tempus non. Curabitur bibendum ornare commodo. Quisque commodo neque sit amet tincidunt lacinia. Proin elementum ante velit, eu congue nulla semper quis. Pellentesque consequat vel nunc at scelerisque. Mauris sit amet venenatis diam, blandit viverra leo. Integer commodo laoreet orci.
+
+Curabitur ipsum tortor, sodales ut augue sed, commodo porttitor libero. Pellentesque molestie vitae mi consectetur tempor. In sed lectus consequat, lobortis neque non, semper ipsum. Etiam eget ex et nibh sagittis pulvinar lacinia ac mauris. Aenean ligula eros, viverra ac nibh at, venenatis semper quam. Sed interdum ligula sit amet massa tincidunt tincidunt. Suspendisse potenti. Aliquam egestas facilisis est, sed faucibus erat scelerisque id. Duis dolor quam, viverra vitae orci euismod, laoreet pellentesque justo. Nunc malesuada non erat at ullamcorper. Mauris eget posuere odio. Vestibulum turpis nunc, pharetra eget ante in, feugiat mollis justo. Proin porttitor, diam nec vulputate pretium, tellus arcu rhoncus turpis, a blandit nisi nulla quis arcu. Nunc ac ullamcorper ligula, nec facilisis leo.
+
+In vitae eros sollicitudin, iaculis ex eget, egestas orci. Etiam sed pretium lorem. Nam nisi enim, consectetur sit amet semper ac, semper pharetra diam. In pulvinar neque sapien, ac ullamcorper est lacinia a. Etiam tincidunt velit sed diam malesuada, eu ornare ex consectetur. Phasellus in imperdiet tellus. Sed bibendum, dui sit amet fringilla aliquet, enim odio sollicitudin lorem, vel semper turpis mauris vel mauris. Aenean congue magna ac massa cursus, in dictum orci commodo. Pellentesque mollis velit in sollicitudin tincidunt. Vestibulum et efficitur nulla.
+
+Quisque posuere, velit sed porttitor dapibus, neque augue fringilla felis, eu luctus nisi nisl nec ipsum. Curabitur pellentesque ac lectus eget ultricies. Vestibulum est dolor, lacinia pharetra vulputate a, facilisis a magna. Nam vitae arcu nibh. Praesent finibus blandit ante, ac gravida ex mollis eget. Donec quam est, pulvinar vitae neque ut, bibendum aliquam erat. Nullam mollis arcu at sem tincidunt, in tristique lectus facilisis. Aenean ut lacus vel nisl finibus iaculis non a turpis. Integer eget ipsum ante. Donec nunc neque, vestibulum ac magna ac, posuere scelerisque dui. Pellentesque massa nibh, rhoncus id dolor quis, placerat posuere turpis. Donec aliquet augue nisi, eu finibus dui auctor et. Vestibulum eu varius lorem. Quisque lectus ante, malesuada pretium risus eget, interdum mattis enim.
+`;

gallery/src/ha-gallery.ts

@@ -5,6 +5,7 @@ import { html, css, LitElement, PropertyValues } from "lit";
 import { customElement, property, query } from "lit/decorators";
 import "../../src/components/ha-icon-button";
 import "../../src/managers/notification-manager";
+import "../../src/components/ha-expansion-panel";
 import { haStyle } from "../../src/resources/styles";
 import { PAGES, SIDEBAR } from "../build/import-pages";
 import { dynamicElement } from "../../src/common/dom/dynamic-element-directive";
@@ -44,6 +45,10 @@ class HaGallery extends LitElement {
       for (const page of group.pages!) {
         const key = `${group.category}/${page}`;
         const active = this._page === key;
+        if (!(key in PAGES)) {
+          console.error("Undefined page referenced in sidebar.js:", key);
+          continue;
+        }
         const title = PAGES[key].metadata.title || page;
         links.push(html`
           <a ?active=${active} href=${`#${group.category}/${page}`}>${title}</a>
@@ -53,10 +58,9 @@ class HaGallery extends LitElement {
       sidebar.push(
         group.header
           ? html`
-              <details>
-                <summary class="section">${group.header}</summary>
+              <ha-expansion-panel .header=${group.header}>
                 ${links}
-              </details>
+              </ha-expansion-panel>
             `
           : links
       );
@@ -92,27 +96,34 @@ class HaGallery extends LitElement {
             ${dynamicElement(`demo-${this._page.replace("/", "-")}`)}
           </div>
           <div class="page-footer">
-            ${PAGES[this._page].description ||
-            Object.keys(PAGES[this._page].metadata).length > 0
-              ? html`
-                  <a
-                    href=${`${GITHUB_DEMO_URL}${this._page}.markdown`}
-                    target="_blank"
-                  >
-                    Edit text
-                  </a>
-                `
-              : ""}
-            ${PAGES[this._page].demo
-              ? html`
-                  <a
-                    href=${`${GITHUB_DEMO_URL}${this._page}.ts`}
-                    target="_blank"
-                  >
-                    Edit demo
-                  </a>
-                `
-              : ""}
+            <div class="header">Help us to improve our documentation</div>
+            <div class="secondary">
+              Suggest an edit to this page, or provide/view feedback for this
+              page.
+            </div>
+            <div>
+              ${PAGES[this._page].description ||
+              Object.keys(PAGES[this._page].metadata).length > 0
+                ? html`
+                    <a
+                      href=${`${GITHUB_DEMO_URL}${this._page}.markdown`}
+                      target="_blank"
+                    >
+                      Edit text
+                    </a>
+                  `
+                : ""}
+              ${PAGES[this._page].demo
+                ? html`
+                    <a
+                      href=${`${GITHUB_DEMO_URL}${this._page}.ts`}
+                      target="_blank"
+                    >
+                      Edit demo
+                    </a>
+                  `
+                : ""}
+            </div>
           </div>
         </div>
       </mwc-drawer>
@@ -186,27 +197,16 @@ class HaGallery extends LitElement {
         padding: 4px;
       }
 
-      .sidebar details {
-        margin-top: 1em;
-        margin-left: 1em;
-      }
-
-      .sidebar summary {
-        cursor: pointer;
-        font-weight: bold;
-        margin-bottom: 8px;
-      }
-
       .sidebar a {
         color: var(--primary-text-color);
         display: block;
-        padding: 4px 12px;
+        padding: 12px;
         text-decoration: none;
         position: relative;
       }
 
       .sidebar a[active]::before {
-        border-radius: 4px;
+        border-radius: 12px;
         position: absolute;
         top: 0;
         right: 2px;
@@ -237,14 +237,32 @@ class HaGallery extends LitElement {
 
       .page-footer {
         text-align: center;
-        margin: 16px 0;
-        padding-top: 16px;
-        border-top: 1px solid rgba(0, 0, 0, 0.12);
+        margin: 16px;
+        padding: 16px;
+        border-radius: 12px;
+        background-color: var(--primary-background-color);
+      }
+
+      .page-footer div {
+        margin-top: 4px;
+      }
+
+      .page-footer .header {
+        font-size: 16px;
+        font-weight: 500;
+        line-height: 28px;
+        text-align: center;
+      }
+
+      .page-footer .secondary {
+        line-height: 23px;
+        text-align: center;
       }
 
       .page-footer a {
         display: inline-block;
         margin: 0 8px;
+        text-decoration: none;
       }
     `,
   ];

gallery/src/pages/brand/logo.markdown

@@ -0,0 +1,34 @@
+---
+title: "Logo"
+---
+
+![Using our logo](/images/using-our-logo.png)
+
+# Using our logo
+
+As a community, we are proud of our logo. Follow these guidelines to ensure it always looks its best. Our logo follows Google's material design spec and uses the blue interface color.
+
+[Download Logo](https://github.com/home-assistant/assets/tree/master/logo)
+
+![Logo](/images/logo.png)
+
+
+## Using the icon
+
+Our icon is a shorter and most used version of our logo. The icon can exist without the wordmark, the wordmark should never exist without the icon.
+
+![Logo variants](/images/logo-variants.png)
+
+## Using the right variant
+
+The pretty blue logo with a background shadow, pictured top left, is our primary logo. It should only be used with black, white, and non-duotone photography.
+
+When needed you can use our logo without a shadow, as seen as the second variant. 
+
+The outlined logo should only be used on packaging.
+
+## Exclusion zone
+
+The logo needs some personal space. It's exclusion zone is equal to a quarter the height of the icon.
+
+![Clearspace](/images/clearspace.png)

gallery/src/pages/brand/our-story.markdown

@@ -0,0 +1,41 @@
+---
+title: "Our story"
+---
+
+## Open source home automation that puts local control and privacy first
+
+Home Assistant is a free and open-source software for home automation that is designed to be the central control system for smart home devices with a focus on local control and privacy. It can be accessed via a web-based user interface, via apps for Android and iOS, or using voice commands via a supported virtual assistant like Google Assistant and Amazon Alexa.
+
+IoT devices and services are supported by modular support for controlling proprietary ecosystems if they provide public access via an Open API for third-party integrations and protocols like Bluetooth, MQTT, Zigbee, and Z-Wave, After the Home Assistant software application is installed as a computer appliance it will act as a central control system for home automation. Information from all entities it sees can be used and controlled from within scripts trigger automations using scheduling and "blueprint" subroutines, e.g. for controlling lighting, climate, entertainment systems, and appliances.
+
+# Open Home
+
+The Open Home is our vision for the smart home. It defines the values that we put at the heart of every decision we make at Home Assistant. It’s woven into our architecture, licensing, community, and everything else.
+
+The Open Home is about privacy, choice, and durability.
+
+## Privacy
+
+Your home should be your safe space. A place where you can be your true self without having to bother about what the world thinks of you. A place where you don’t need to act differently to avoid an algorithm categorizing your behavior. Privacy for the Open Home means that devices need to work locally. No one else needs to know if you turn on a light bulb or change the thermostat.
+
+It is okay for a product to offer a cloud connection, but it should be extra and opt-in.
+
+## Choice
+
+Devices in your home gather data about themselves and their surroundings. Your data. Vendors shouldn’t be able to limit your access to your data or limit the interoperability of your devices with the rest of your smart home.
+
+Choice for the Open Home means that devices need to make the gathered data available through local APIs. This avoids vendor lock-in and allows users to create their own smart home with devices from different manufacturers.
+
+## Durability
+
+If there is one thing that technology firms are very good at, it is launching new products. However, maintaining the products and making sure they keep working is an afterthought for most. The result is that vendors can decide to no longer support your device, crippling its features or even preventing it from working at all. As we install more and more devices in our home, durability is becoming more and more important. We shouldn’t have to buy everything new every couple of years because the manufacturer decided to move on.
+
+Durability for the Open Home means that devices are designed and built to keep working. Not just this year, but for the next decade.
+
+# Our history
+
+The project was started as a Python application by Paulus Schoutsen in September 2013 and first published publicly on GitHub in November 2013. In July 2017, a managed operating system called Hass.io was initially introduced to make it easier use to use Home Assistant on single-board computers like the Raspberry Pi series. Its bundled "supervisor" management system allowed users to manage, backup, and update the local installation and introduced the option to extend the functionality of the software with add-ons.
+
+An optional subscription service was introduced in December 2017 for $5/month to solve the complexities associated with secured remote access, as well as linking to Amazon Alexa and Google Assistant. Nabu Casa, Inc. was formed in September 2018 to take over the subscription service. The company's funding is based solely on revenue from the subscription service. It is used to finance the project's infrastructure and to pay for full-time employees contributing to the project.
+
+In January 2020, branding was adjusted to make it easier to refer to different parts of the project. The main piece of software was renamed to Home Assistant Core, while the full suite of software with the embedded operating system and bundled "supervisor" management system was renamed to Home Assistant.

gallery/src/pages/components/ha-alert.markdown

@@ -1,5 +1,6 @@
 ---
 title: Alerts
+subtitle: An alert displays a short, important message in a way that attracts the user's attention without interrupting the user's task.
 ---
 
 # Alert `<ha-alert>`