> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Building BI on mobile

> Navigate Building BI collections, open published dashboards, and apply filters on the KODE OS mobile app.

Check a published dashboard from the field instead of waiting until you're back at a desk. Mobile delivers the analytics published from [Building BI](/products/building-bi/overview), the KODE OS analytics and dashboard module. You browse collections, open dashboards and reports, apply filters, and favorite items for quick return. Dashboard design and publishing stay on the web.

## How to open Building BI

<Tabs>
  <Tab title="From portfolio">
    Swipe up the `Portfolio` sheet and select `BuildingBI`. The map stays visible behind the sheet until the module loads.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Building BI in the portfolio module list">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi-portfolio-nav.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=d4b021a93548654164fe7268fd0b009e" alt="Portfolio sheet with Building BI module listed below Sites" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-building-bi-portfolio-nav.png" />
      </Frame>
    </div>
  </Tab>

  <Tab title="From a site">
    After you [enter a site](/products/mobile-app/portfolio/portfolio-and-sites#enter-a-site), open `Building BI` from the building app launcher. Content is scoped to that site's published artifacts.
  </Tab>
</Tabs>

## Collections home

The `BuildingBI` home screen lists collections as expandable sections. Only collections and dashboards your administrator published to mobile appear here.

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=bf729401d7f0bfb6c581e87c500fbe4b" alt="Building BI home with Favorites, Dashboard Collection, and Switch Site footer for KODE 1420 Office" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-building-bi.png" />
  </Frame>
</div>

### Collection sections

| Section                | Typical contents                                                                                  |
| ---------------------- | ------------------------------------------------------------------------------------------------- |
| `Favorites`            | Starred dashboards such as `Lighting Occupancy` and `Operations Dashboard`                        |
| `Dashboard Collection` | Curated sets such as `Operations`, `Comfort & Air Quality`, `Traffic & Occupancy`, and `Lighting` |
| `Dashboards`           | Individual dashboards with author and age metadata                                                |

### Row and header controls

| Element                               | Action                                                              |
| ------------------------------------- | ------------------------------------------------------------------- |
| Chevron on section header             | Expand or collapse the collection                                   |
| `Published` badge                     | Confirms the collection is available on mobile                      |
| Eye icon                              | Open the published collection view                                  |
| Age label (for example, `7 days ago`) | Last publish or sync time                                           |
| Dashboard row                         | Tap to open that dashboard                                          |
| Star                                  | Favorite the dashboard for quicker access                           |
| Overflow (⋯)                          | Share or secondary actions when enabled                             |
| Header search/history icon            | Search dashboards or open recent items (organization configuration) |
| Bell (FAB)                            | Notifications related to Building BI or the current site            |

## Open a dashboard or report

<Steps>
  <Step title="Expand a collection">
    Tap the section header or chevron to show child dashboards.
  </Step>

  <Step title="Select a report">
    Tap a row such as `Operations Dashboard`. The dashboard opens full screen with its page title and tabs.
  </Step>

  <Step title="Switch report pages">
    Use the title dropdown (for example, `Operations Dashboard` ▼) to change report definitions or tabs such as `Overview` when the author published multiple views.
  </Step>
</Steps>

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Operations Dashboard — Overview">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi-energy-report.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=faa24365ec082cfe76942a8de82e88a1" alt="Operations Dashboard Overview with zone temperature chart, average floor temperature heatmap, and Device Details and Floor Plans links" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-building-bi-energy-report.png" />
  </Frame>
</div>

Inside a dashboard you can:

* Scroll vertically through KPI tiles, charts, tables, and floor plan graphics
* Open linked views such as `Device Details` and `Floor Plans` when the author added them
* Tap the blue refresh FAB to reload data after filters change

When the author enabled `Mobile Layout` on the web, widgets resize and stack for phone screens. Dashboards without that configuration render the desktop layout instead. Scroll vertically in portrait or rotate to landscape for a wider view.

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Training Overview without mobile layout (portrait)">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi-no-mobile-layout.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=651f0341b2ac45dc216372a31ec37f21" alt="Training Overview dashboard in portrait with weather widget, floor plan graphic with temperature labels, and average temp heatmap without a mobile layout configured" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-building-bi-no-mobile-layout.png" />
  </Frame>
</div>

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Training Overview without mobile layout (landscape)">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi-no-mobile-layout-landscape.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=8c8b58b3865087ca49a69b7c482813be" alt="Training Overview dashboard in landscape with weather widget, floor plan graphic, filter panel, and AVG Temp heatmap without a mobile layout configured" width="720" height="332" data-path="images/mobile-app/kode-os-mobile-building-bi-no-mobile-layout-landscape.png" />
  </Frame>
</div>

## Apply filters

Tap the filter icon in the dashboard header to open `Filters`.

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/mobile-app/kode-os-mobile-building-bi-filters.png?fit=max&auto=format&n=QV43LEddE2aJcRYU&q=85&s=a1c5d230b9995bdfcf9c68c9020a6370" alt="Filters screen with Date Time Local row and Apply button" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-building-bi-filters.png" />
  </Frame>
</div>

### Filter bar segments

The top icon row switches filter categories:

| Segment                                     | Purpose                                    |
| ------------------------------------------- | ------------------------------------------ |
| Funnel                                      | Standard dimension filters                 |
| Document + funnel (highlighted when active) | Report- or template-specific parameters    |
| Funnel with arrow                           | Saved or reset filter sets when configured |

### Filter rows

Tap a row such as `Date Time Local` to set the range or dimension. Select `Apply` at the bottom to refresh the dashboard. Cancel with the back arrow to discard changes.

<Note>
  Available filters depend on how the dashboard was authored on the web. If only `Date Time Local` appears, other slicers may be fixed inside the report layout.
</Note>

## Favorites and return navigation

* Tap the star on a dashboard row in the collections list to favorite it.
* Use the back arrow in the dashboard header to return to `BuildingBI` collections.
* Use the `Portfolio` sheet to switch to `Sites` or another portfolio module without signing out.

## What to do on web vs mobile

| Task                                  | Platform                                                           |
| ------------------------------------- | ------------------------------------------------------------------ |
| Create or edit dashboards and widgets | Web [Building BI](/products/building-bi/dashboards)                |
| Publish to mobile / manage deployment | Web [Deployment manager](/products/building-bi/deployment-manager) |
| Browse and filter published content   | Mobile (this guide)                                                |
| Collections and data sources setup    | Web [Collections](/products/building-bi/collections)               |

## Next steps

<CardGroup cols={2}>
  <Card title="Portfolio and sites" icon="map" href="/products/mobile-app/portfolio/portfolio-and-sites" arrow={true}>
    Use the map, site cards, and site switcher.
  </Card>

  <Card title="Trends on mobile" icon="chart-line" href="/products/mobile-app/analytics/trends" arrow={true}>
    Chart points and save shared views.
  </Card>
</CardGroup>