### Manual Installation Build Command

Source: https://github.com/digilive/mushroom-strategy/wiki/Home

Use this command to build the strategy for manual installation or testing purposes. Ensure you have Node.js and npm installed.

```bash
npm build
or
npm build-dev
```

--------------------------------

### Serve Documentation Locally

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/documentation.md

Starts the local development server for previewing documentation changes. This command must be run from the project root.

```bash
mkdocs serve
```

--------------------------------

### Example versions.json Structure

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Illustrates the structure of the versions.json file, showing version details and aliases.

```json
[
  {
    "version": "main",
    "title": "main",
    "aliases": []
  },
  {
    "version": "v1.0.0",
    "title": "v1.0.0",
    "aliases": ["latest"]
  }
]
```

--------------------------------

### Install Core Documentation Stack

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Installs the necessary Python packages for the documentation build and serving process.

```bash
pip install -r requirements.txt
```

--------------------------------

### Install Python Documentation Tools

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/getting-started.md

Execute this command in the project root to install MkDocs and its required themes/plugins for documentation management.

```bash
pip install mkdocs mkdocs-material mkdocs-material-extensions
```

--------------------------------

### Install Node.js Dependencies

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/getting-started.md

Run this command in the project root to install all necessary Node.js packages for development.

```bash
npm install
```

--------------------------------

### Basic Strategy Configuration with Area Options

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Example of setting up the Mushroom strategy with custom options for areas, including name, icon, and icon color.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    areas:
      family_room_id:
        name: Family Room
        icon: mdi:sofa
        icon_color: green
views: []
```

--------------------------------

### Configure Specific Areas and Extra Cards

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/area-options.md

Demonstrates how to set up individual areas with custom names, icons, order, and additional cards. Includes examples for a 'Family Room' with chips, a 'Kitchen', a hidden 'Hallway', and a 'HaAreaCard' with a vacuum map.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    show_positions: true
    areas:
      family_room_id:
        name: Family Room
        icon: mdi:television
        icon_color: green
        order: 10
        extra_cards:
          - type: custom:mushroom-chips-card
            chips:
              - type: entity
                entity: sensor.family_room_temperature
                icon: mdi:thermometer
                icon_color: pink
            alignment: center
      kitchen_id:
        name: Kitchen
        icon: mdi:silverware-fork-knife
        icon_color: red
        order: 20
      garage_id:
        hidden: true
      hallway_id:
        type: HaAreaCard
        extra_cards:
          - type: custom:xiaomi-vacuum-map-card
            map_source:
              camera: camera.xiaomi_cloud_map_extractor
            calibration_source:
              camera: true
            entity: vacuum.robot_vacuum
            vacuum_platform: default
views: []

```

--------------------------------

### Configure Element Positioning and Areas

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/index.md

This example demonstrates how to enable the visibility of element ordering positions and configure specific areas with custom names, icons, and order values. Use 'order' to control the arrangement of elements.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    show_positions: true
    areas:
      family_room_id:
        name: Family Room
        icon: mdi:sofa
        icon_color: green
        order: 10
      kitchen_id:
        name: Kitchen
        icon: mdi:fridge
        icon_color: blue
        order: 20
```

--------------------------------

### Commit Message Example

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/workflow.md

Follow this format for commit messages to ensure clarity and consistency. Include a concise subject line and a detailed body if necessary.

```text
Fix: Resolve issue with feature X
 
A clear and concise description of what has been changed, why it was necessary, and any relevant context.
```

--------------------------------

### Mushroom Strategy Full Configuration

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/full-example.md

This is a complete configuration example for the Mushroom Strategy, showcasing all available options for customization. It includes settings for views, areas, badges, and card layouts.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    show_positions: true
    views:
      light:
        order: 10
        title: illumination
      switches:
        hidden: true
        icon: mdi:toggle-switch
    home_view:
      hidden:
        greeting: false
        areas_title: true
      stack_count:
        areas: [2, 1]
        persons: 3
    domains:
      _: 
        hide_config_entities: true
        stack_count: 1
      default:
        hidden_domains:
          - automation
          - script
      light:
        order: 10
        stack_count: 2
        title: "My cool lights"
        hide_diagnostic_entities: false
        hide_unavailable_entities: true
    badges:
      weather_entity: weather.forecast_home
      climate_count: false
      cover_count: false
      extra_badges:
        - type: custom:mushroom-template-badge
          content: Hello
          icon: mdi:mushroom
          color: red
        - type: entity
          show_name: false
          show_state: true
          show_icon: true
          entity: light.kitchen
          tap_action:
            action: toggle
    areas:
      _: 
        type: default
      family_room_id:
        name: Family Room
        icon: mdi:television
        icon_color: green
        extra_cards:
          - type: custom:mushroom-badges-card
            badges:
              - type: entity
                entity: sensor.family_room_temperature
                icon: mdi:thermometer
                icon_color: pink
            alignment: center
      kitchen_id:
        name: Kitchen
        icon: mdi:silverware-fork-knife
        icon_color: red
        order: 10
      master_bedroom_id:
        name: Master Bedroom
        icon: mdi:bed-king
        icon_color: blue
      kids_bedroom_id:
        name: Kids Bedroom
        icon: mdi:flower-tulip
        icon_color: green
    card_options:
      fan.master_bedroom_fan:
        type: custom:mushroom-fan-card
      remote.harmony_hub_wk:
        hidden: true
    quick_access_cards:
      - type: custom:mushroom-cover-card
        entity: cover.garage_door
        show_buttons_control: true
      - type: horizontal-stack
        cards:
          - type: custom:mushroom-lock-card
            entity: lock.front_door
          - type: custom:mushroom-entity-card
            entity: sensor.front_door_lock_battery
            name: Battery
    extra_cards:
      - type: custom:xiaomi-vacuum-map-card
        map_source:
          camera: camera.xiaomi_cloud_map_extractor
        calibration_source:
          camera: true
        entity: vacuum.robot_vacuum
        vacuum_platform: default
    extra_views:
      - theme: Backend-selected
        title: Cool view
        path: cool-view
        icon: mdi:emoticon-cool
        badges: []
        cards:
          - type: markdown
            content: I am cool

```

--------------------------------

### Configure Quick Access Cards in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Use `quick_access_cards` to define navigation elements at the top of the home view. This example shows a title card, a cover card, and a horizontal stack of lock and battery entity cards.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    quick_access_cards:
      - type: custom:mushroom-title-card
        title: Security
      - type: custom:mushroom-cover-card
        entity: cover.garage_door
        show_buttons_control: true
      - type: horizontal-stack
        cards:
          - type: custom:mushroom-lock-card
            entity: lock.front_door
          - type: custom:mushroom-entity-card
            entity: sensor.front_door_lock_battery
            name: Battery
```

--------------------------------

### Configure Extra Cards in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Utilize `extra_cards` to add custom cards below the main areas of the home view. This example configures a Xiaomi vacuum map card.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    extra_cards:
      - type: custom:xiaomi-vacuum-map-card
        map_source:
          camera: camera.xiaomi_cloud_map_extractor
        calibration_source:
          camera: true
        entity: vacuum.robot_vacuum
        vacuum_platform: default
```

--------------------------------

### Custom Mushroom Strategy with Extra Cards

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Example of a custom Mushroom strategy that includes extra cards, such as a Xiaomi vacuum map card, within its options.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    extra_cards:
      - type: custom:xiaomi-vacuum-map-card
        map_source:
          camera: camera.xiaomi_cloud_map_extractor
        calibration_source:
          camera: true
        entity: vacuum.robot_vacuum
        vacuum_platform: default
views: []
```

--------------------------------

### Setting Default Area Card Type in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Example showing how to set a default card type for all areas using the wildcard identifier '_' in the strategy options.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    areas:
      _:
        type: HaAreaCard
views: []
```

--------------------------------

### Import and Register New Language

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/translations.md

Add import statements and register the new language in the 'languages' map within localize.ts. This example shows how to import English and Portuguese (Brazil) translations and register them.

```typescript
import * as en from '../translations/en.json';
import * as pt_br from '../translations/pt-BR.json';

/** Registry of currently supported languages */
const languages: Record<string, unknown> = {
  en,
  'pt-BR': pt_br,
};
```

--------------------------------

### Deploy and Serve Versioned Documentation Locally

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Deploys the current branch as a local-only version and serves the versioned site to test the version selector.

```bash
# Deploy your current branch to a local-only version name
mike deploy main-local

# Serve the versioned site
mike serve
```

--------------------------------

### Configuring Domain Options for All and Specific Domains

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Demonstrates how to set default options for all domains using `_` and specific configurations for 'light', 'switch', and 'default' domains. Use this to hide config/diagnostic entities or set custom titles and ordering.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    domains:
      _:
        hide_config_entities: false
      light:
        title: "My cool lights"
        order: 1
      switch:
        showControls: false
      default:
        hidden: true
views: []
```

--------------------------------

### Build Strategy (Production)

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/code.md

Use this command to build the strategy for production deployment. Ensure all tests pass after building.

```bash
npm run build
```

--------------------------------

### Build Strategy Locally

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/getting-started/installation.md

Use these commands to build the strategy for local testing. Ensure you refresh your client's cache after copying build files.

```bash
npm build

```

```bash
npm build-dev

```

--------------------------------

### Build Strategy (Development)

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/code.md

Use this command to build the strategy for development and testing. This build may include additional debugging information.

```bash
npm run build-dev
```

--------------------------------

### Format Code

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/code.md

Run this command to format your code according to project standards. This ensures consistency and readability.

```bash
npm run ts:format
```

--------------------------------

### Setting Options for All Domains

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/domain-options.md

Use the wildcard '_' to define default options for all domains. This configuration sets a default stack count and hides configuration entities for all domains unless overridden.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    show_positions: true
    domains:
      _: 
        stack_count: 2
        hide_config_entities: false
      light:
        title: "My cool lights"
        order: 10
      switch:
        stack_count: 3
        show_controls: false
        hide_diagnostic_entities: false
        order: 20
      fan:
        hide_unavailable_entities: true
      default: # All other domains
        hidden: true
```

--------------------------------

### Initialize gh-pages Branch and Default Version

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Ensures the gh-pages branch is available locally and sets the 'latest' alias to point to the 'main' branch for the default landing page.

```bash
git fetch origin gh-pages --depth=1

mike set-default --push latest
```

--------------------------------

### Package.json Scripts for Documentation Workflow

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Adds convenience scripts to package.json for common documentation tasks like serving, listing versions, and serving versioned sites.

```json
{
  "...": "...",
  "scripts": {
    "docs:serve": "mkdocs serve",
    "docs:serve-versioned": "mike serve",
    "docs:list": "mike list",
    "...": "..."
  }
}
```

--------------------------------

### Format and Lint Code

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/translations.md

Run these commands to format and lint your code changes before committing.

```bash
npm run json:format
```

```bash
npm run ts:format
```

```bash
npm run build
```

--------------------------------

### Mkdocs.yml Configuration for Mike

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Essential configuration block for mkdocs.yml to enable Mike's UI integration for version selection.

```yaml
extra:
  version:
    provider: mike
```

--------------------------------

### Configuring Areas in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Demonstrates how to configure individual areas within a custom Mushroom strategy, including setting names, icons, order, and extra cards.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    areas:
      family_room_id:
        name: Family Room
        icon: mdi:television
        icon_color: green
        order: 1
        extra_cards:
          - type: custom:mushroom-chips-card
            chips:
              - type: entity
                entity: sensor.family_room_temperature
                icon: mdi:thermometer
                icon_color: pink
            alignment: center
      kitchen_id:
        name: Kitchen
        icon: mdi:silverware-fork-knife
        icon_color: red
        order: 2
      garage_id:
        hidden: true
      hallway_id:
        type: HaAreaCard
        extra_cards:
          - type: custom:xiaomi-vacuum-map-card
            map_source:
              camera: camera.xiaomi_cloud_map_extractor
            calibration_source:
              camera: true
            entity: vacuum.robot_vacuum
            vacuum_platform: default
views: []
```

--------------------------------

### Configure Chip Options in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Customize the display and behavior of chips in the Home view using the `chips` option. This includes enabling/disabling counts for different domains (lights, fans, covers, switches, climate) and specifying a weather entity.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    chips:
      climate_count: false
      cover_count: false
      weather_entity: weather.forecast_home
      extra_chips:
        - type: conditional
          conditions:
            - entity: lock.front_door
              state: unlocked
          chip:
            type: entity
            entity: lock.front_door
            icon_color: red
            content_info: none
            tap_action:
              action: toggle
```

--------------------------------

### Configure Stack Count for Home View Sections

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Define the number of cards to display per row for different sections of the Home view. Section-specific counts override the default.

```YAML
home_view:
  stack_count:
    _: 2         # Two cards per row for all sections.
    persons: 3   # Three person cards per row.
    areas: [2,1] # [Two Strategy Card per row, 1 HASS card per row]
```

--------------------------------

### Basic Dashboard Strategy Configuration

Source: https://github.com/digilive/mushroom-strategy/wiki/Home

This YAML configuration snippet shows how to apply the custom Mushroom Strategy to a Home Assistant dashboard. Replace the existing configuration in the raw editor.

```yaml
strategy:
  type: custom:mushroom-strategy
views: []
```

--------------------------------

### Format and Lint Documentation

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/contributing/documentation.md

Runs the linter to check for and fix broken links, formatting issues, and common Markdown errors. This ensures consistency before committing changes.

```bash
npm run md:lint-fix
```

--------------------------------

### Full Mushroom Strategy Configuration

Source: https://github.com/digilive/mushroom-strategy/wiki/Full-Example

This configuration demonstrates the extensive options available for the mushroom-strategy, covering views, domains, chips, areas, card options, quick access, and extra cards. It's useful for creating a highly customized dashboard.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    views:
      light:
        title: illumination
        order: 1
      switches:
        hidden: true
        icon: mdi:toggle-switch
    home_view:
      hidden:
        - greeting
        - areasTitle
    domains:
      _: 
        hide_config_entities: true
      light:
        title: "My cool lights"
        order: 1
    chips:
      weather_entity: weather.forecast_home
      climate_count: false
      cover_count: false
      extra_chips:
        - type: conditional
          conditions:
            - entity: lock.front_door
              state: unlocked
          chip:
            type: entity
            entity: lock.front_door
            icon_color: red
            content_info: none
            icon: ''
            use_entity_picture: false
            tap_action:
              action: toggle
        - type: conditional
          conditions:
            - entity: cover.garage_door
              state_not: closed
          chip:
            type: entity
            entity: cover.garage_door
            icon_color: red
            content_info: none
            tap_action:
              action: toggle
    areas:
      _: 
        type: default
      family_room_id:
        name: Family Room
        icon: mdi:television
        icon_color: green
        extra_cards:
          - type: custom:mushroom-chips-card
            chips:
              - type: entity
                entity: sensor.family_room_temperature
                icon: mdi:thermometer
                icon_color: pink
            alignment: center
      kitchen_id:
        name: Kitchen
        icon: mdi:silverware-fork-knife
        icon_color: red
        order: 1
      master_bedroom_id:
        name: Master Bedroom
        icon: mdi:bed-king
        icon_color: blue
      kids_bedroom_id:
        name: Kids Bedroom
        icon: mdi:flower-tulip
        icon_color: green
    card_options:
      fan.master_bedroom_fan:
        type: custom:mushroom-fan-card
      remote.harmony_hub_wk:
        hidden: true
    quick_access_cards:
      - type: custom:mushroom-cover-card
        entity: cover.garage_door
        show_buttons_control: true
      - type: horizontal-stack
        cards:
          - type: custom:mushroom-lock-card
            entity: lock.front_door
          - type: custom:mushroom-entity-card
            entity: sensor.front_door_lock_battery
            name: Battery
    extra_cards:
      - type: custom:xiaomi-vacuum-map-card
        map_source:
          camera: camera.xiaomi_cloud_map_extractor
        calibration_source:
          camera: true
        entity: vacuum.robot_vacuum
        vacuum_platform: default
    extra_views:
      - theme: Backend-selected
        title: Cool view
        path: cool-view
        icon: mdi:emoticon-cool
        badges: []
        cards:
          - type: markdown
            content: I am cool
views: []

```

--------------------------------

### Rebuild versions.json using Mike Aliases

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Commands to recreate the versions.json file on the gh-pages branch by re-aliasing existing versions.

```bash
mike alias main main
mike alias <your-latest-tag> latest
```

--------------------------------

### Basic Strategy Configuration

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/index.md

This is the basic structure for configuring the custom:mushroom-strategy. It shows where to place custom options within the YAML.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    # Custom Configuration
```

--------------------------------

### Add Extra Views with Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/view-options.md

Configure additional views using the 'extra_views' option. These views can be customized with themes, titles, paths, ordering, icons, badges, and cards, similar to standard Home Assistant views.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    extra_views:
      - theme: Backend-selected
        title: cool view
        path: cool-view
        order: Infinity
        icon: mdi:emoticon-cool
        badges: []
        cards:
          - type: markdown
            content: I am cool
```

--------------------------------

### Mike Maintenance Commands

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Provides essential commands for managing documentation versions, including deleting, listing, and aliasing.

```bash
mike delete <version_name>
```

```bash
mike list
```

```bash
mike alias <version_number> latest
```

```bash
mike set-default latest
```

--------------------------------

### Configure Badge Options for Home View

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Enable or disable specific badges and set a custom entity for the weather badge. Hidden or disabled entities are excluded from counts.

```YAML
strategy:
  type: custom:mushroom-strategy
  options:
    badges:
      climate_count: false
      cover_count: false
      weather_entity: weather.forecast_home
```

--------------------------------

### Hide Home View Sections

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Specify which sections of the Home view should be hidden. Set the corresponding option to `true` to hide, or `false` to show.

```YAML
strategy:
  type: custom:mushroom-strategy
  options:
    home_view:
      hidden:
        greeting: false
        areas_title: true
```

--------------------------------

### Add Custom Badges to Home View

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/home-view-options.md

Include custom badges by defining them in the `extra_badges` list. Supports Mushroom and standard Home Assistant entity badges.

```YAML
strategy:
  type: custom:mushroom-strategy
  options:
    badges:
      extra_badges:
        - type: custom:mushroom-template-badge
          content: Hello
          icon: mdi:mushroom
          color: red
        - type: entity
          show_name: false
          show_state: true
          show_icon: true
          entity: light.kitchen
          tap_action:
            action: toggle
```

--------------------------------

### Configure Entity Cards in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Customize individual entity cards using `card_options`. You can specify card types, icons, or hide cards entirely. Device IDs can be used to configure all entities associated with a device.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    card_options:
      fan.master_bedroom_fan:
        type: custom:mushroom-fan-card
        icon: mdi:fan
      remote.harmony_hub_wk:
        hidden: true
      077ba0492c9bb3b3134f1f3a626a:
        hidden: true

views: []
```

--------------------------------

### Configure Card Options

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/card-options.md

Specify card types and visibility for entities. You can set a specific card type for an entity or hide it entirely. Providing a device ID will hide all associated entities.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    card_options:
      fan.master_bedroom_fan:
        type: custom:mushroom-fan-card
        icon: mdi:fan
      remote.harmony_hub_wk:
        hidden: true
      077ba0492c9bb3b3134f1f3a626a: # this is a device id
        hidden: true
```

--------------------------------

### Apply Mushroom Strategy to Dashboard

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/getting-started/basic-setup.md

Add this configuration to your dashboard's raw configuration to enable the Mushroom Strategy. Ensure the options are correctly formatted.

```yaml
strategy:
  type: custom:mushroom-strategy
  options: {}
```

--------------------------------

### Configure Views in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Use the `views` option to customize the order, title, and visibility of specific domain views. Set `hidden: true` to exclude a view from the dashboard.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    views:
      light:
        order: 0
        title: illumination
      switch:
        order: 1
        hidden: true
        icon: mdi:toggle-switch
views: []
```

--------------------------------

### Configure Built-in Views with Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/view-options.md

Use the 'views' option to configure built-in views. You can set the order, hide views, and customize icons and titles. Hidden views are excluded from the dashboard.

```yaml
strategy:
  type: custom:mushroom-strategy
  show_positions: true
  options:
    views:
      light:
        order: 10
        title: illumination
      switch:
        order: 20
        hidden: true
        icon: mdi:toggle-switch
      fan:
        order: 30
        icon: mdi:fan
views: []
```

--------------------------------

### Add Strategy Type to Dashboard Configuration

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/faq.md

Use this YAML configuration to enable the Mushroom Strategy on your dashboard. This is a prerequisite for taking control and editing the raw configuration.

```yaml
strategy:
  type: custom:mushroom-strategy
```

--------------------------------

### Configure Custom Extra Views in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Use the `extra_views` option to define custom views with specific themes, titles, icons, and card layouts. This allows for highly personalized dashboard sections.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    extra_views:
      - theme: Backend-selected
        title: cool view
        path: cool-view
        icon: mdi:emoticon-cool
        badges: []
        cards:
          - type: markdown
            content: I am cool
views: []
```

--------------------------------

### Commit and Push Fix for versions.json

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Commits the restored versions.json file and pushes the changes to the gh-pages branch.

```bash
git add versions.json
git commit -m "fix: restore versions.json"
git push origin gh-pages
```

--------------------------------

### Error Loading Dashboard Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Home

This error typically indicates cache issues or problems with HACS integration. Try clearing your client's cache or re-downloading the strategy from HACS.

```text
Error loading the dashboard strategy:
    Error: Timeout waiting for strategy
    element ||-strategy-mushroom-strategy to
    be registered
```

--------------------------------

### Add Extra Cards Below Areas in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Use the `extra_cards` option to append custom cards below the 'areas' section on the Home view. This provides a space for additional information or controls.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    extra_cards:
      - type: custom:mushroom-title-card
        title: Security
      - type: custom:mushroom-cover-card
        entity: cover.garage_door
        show_buttons_control: true
      - type: horizontal-stack
        cards:
          - type: custom:mushroom-lock-card
            entity: lock.front_door
          - type: custom:mushroom-entity-card
            entity: sensor.front_door_lock_battery
            name: Battery
```

--------------------------------

### Sync Local gh-pages Branch

Source: https://github.com/digilive/mushroom-strategy/blob/main/maintainer-notes.md

Synchronizes the local gh-pages branch with the remote repository to ensure consistency.

```bash
git checkout gh-pages && git pull origin gh-pages
```

--------------------------------

### Hide Sections from Home View in Mushroom Strategy

Source: https://github.com/digilive/mushroom-strategy/wiki/Strategy-Options

Configure the `home_view.hidden` option to exclude specific sections like 'greeting' or 'areasTitle' from the Home view. This helps declutter the main dashboard.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    home_view:
      hidden:
        - greeting
        - areasTitle
views: []
```

--------------------------------

### Hide Automations and Scripts from Miscellaneous Section

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/domain-options.md

Use the 'hidden_domains' option under the 'default' domain to exclude specific entities from the 'Miscellaneous' section in an Area view.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    domains:
      default: # All other domains
        hidden_domains:
          - automation
          - script
```

--------------------------------

### Set Default Type for All Areas

Source: https://github.com/digilive/mushroom-strategy/blob/main/docs/options/area-options.md

Applies a default card type ('HaAreaCard') to all areas unless overridden by specific area configurations. This is useful for consistent area card display.

```yaml
strategy:
  type: custom:mushroom-strategy
  options:
    areas:
      _:
        type: HaAreaCard
views: []

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.