> ## 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.

# Navigate the KODE OS mobile app

> Move between your organization, portfolio map, building site, and apps in the KODE OS mobile app.

The mobile app has four levels of context: **workspace**, **organization**, **site**, and **module**. Most field work stays inside one site (building) at a time.

A **workspace** is your company login domain. An **organization** is the account that owns your sites and apps. A **site** is one building. A **module** is an app such as Events, Devices, or Schedules.

```mermaid actions={false} theme={"theme":{"light":"github-dark","dark":"github-dark"}}
---
config:
  theme: neutral
  layout: dagre
---
flowchart TB
  A["Workspace sign-in"] --> B["Organization"]
  B --> C["Portfolio map or module picker"]
  C --> D["Site context"]
  D --> E["Site module launcher"]
  E --> F["Module screen"]

  linkStyle 0 stroke:#00C853,fill:none
  linkStyle 1 stroke:#00C853,fill:none
  linkStyle 2 stroke:#00C853,fill:none
  linkStyle 3 stroke:#00C853,fill:none
  linkStyle 4 stroke:#00C853,fill:none
```

## Organization context

After [sign-in](/products/mobile-app/get-started/sign-in-and-workspace), you work in one organization at a time. That organization controls which sites, apps, and data you see.

| Goal                | Where to go                                                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Switch organization | Profile → `Switch Organization`. See [Customize your experience](/products/mobile-app/get-started/customize-experience#switch-organization). |
| Return to sign-in   | Profile → `Log out`                                                                                                                          |

Changing organization reloads the portfolio, site list, and every module. Bookmarks stay on the device but show data for the active organization only.

<Note>
  If you only see one organization, your administrator has not granted access to others.
</Note>

## Portfolio vs building apps

KODE OS separates **portfolio** tools (all sites) from **building** apps (one site).

| Level         | How you open it                                                                                                                        | What it covers                                         |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| **Portfolio** | Swipe up the bottom sheet on the map; pick `Sites`, `Dashboards`, `Building BI`, `FDD`, `FTT`, `Work Orders`, `Bookmarks`, or `Search` | All sites you can access, or cross-site views          |
| **Building**  | Select a site, then open a module from the [site module launcher](#site-module-launcher)                                               | One building (devices, events, schedules, and similar) |

Use portfolio tools when you compare sites. Use the building launcher when you operate equipment or triage events for one building.

Details for the map, sort, and search are in [Portfolio and sites](/products/mobile-app/portfolio/portfolio-and-sites).

## Site context

When you enter a building module, the bottom bar shows the **active site** and `Switch Site`.

| Action               | What happens                                                               |
| -------------------- | -------------------------------------------------------------------------- |
| `Switch Site`        | Opens site selection; choosing another site reloads data for that building |
| Stay on current site | All module screens share the same site until you switch                    |
| Return to map        | Swipe up `Portfolio` / `All Sites Overview` without signing out            |

Site context does not change your organization. It only changes which building’s points, events, and assets load.

## Site module launcher

After you [enter a site](/products/mobile-app/portfolio/portfolio-and-sites#enter-a-site), swipe up the bottom sheet to open the **app launcher**. The header shows the site name, address, and `Switch Site`.

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Site module launcher for KODE 1420 Office">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-site-module-launcher.png?fit=max&auto=format&n=MYYnSdKhTqQf34f4&q=85&s=e84dc8a43daf6e39f12a35fe1db63ec5" alt="Site module launcher with Systems, Areas, Devices, Points, and Data Sources icons and a list of Building BI, FDD Events, FDD Faults, FTT, Schedules, Trends, and OSS modules" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-site-module-launcher.png" />
  </Frame>
</div>

A checkmark shows the active module. Tap a row or icon to switch apps.

<AccordionGroup>
  <Accordion title="Quick access icons">
    | Icon           | Module                            | Guide                                                        |
    | -------------- | --------------------------------- | ------------------------------------------------------------ |
    | `Systems`      | Plant and equipment groupings     | [Systems](/products/mobile-app/destinations/systems)         |
    | `Areas`        | Floors, zones, and floor plans    | [Areas and floor plans](/products/mobile-app/building/areas) |
    | `Devices`      | Equipment lists and device detail | [Devices](/products/mobile-app/building/devices)             |
    | `Points`       | Point status, filters, and writes | [Points](/products/mobile-app/building/points)               |
    | `Data Sources` | Connectors and collection status  | [Data sources](/products/mobile-app/building/data-sources)   |
  </Accordion>

  <Accordion title="Module list rows">
    | Module        | Guide                                                                     |
    | ------------- | ------------------------------------------------------------------------- |
    | `Building BI` | [Building BI](/products/mobile-app/destinations/building-bi)              |
    | `FDD Events`  | [Events](/products/mobile-app/events/work-with-events)                    |
    | `FDD Faults`  | [Manage FDD faults](/products/mobile-app/diagnostics/manage-fdd-faults)   |
    | `FTT`         | [Functional testing](/products/mobile-app/diagnostics/functional-testing) |
    | `Schedules`   | [Schedules](/products/mobile-app/operations/schedules)                    |
    | `Trends`      | [Trends](/products/mobile-app/analytics/trends)                           |
    | `OSS`         | [Optimized start/stop](/products/mobile-app/operations/oss)               |

    Your site may also publish `Work Orders`, `Manual Meters`, `Bookmarks`, or `Writable Points` when your role and product enablement allow.
  </Accordion>
</AccordionGroup>

<Info>
  If a module is missing from the launcher, your role or site may not include it. AssetOps apps such as `Work Orders` require AssetOps to be enabled for the building. Confirm assignments with your administrator or in [Launchpad](/products/launchpad/channel-partners/product-enablement) on the web.
</Info>

## Inside a module

Most building apps share the same screen patterns.

| Control          | Typical use                                                       |
| ---------------- | ----------------------------------------------------------------- |
| `Back` (chevron) | Return to the previous list or parent screen                      |
| Title            | Current asset, event, work order, or view name                    |
| Chat / comments  | Collaboration on work orders, faults, or events when shown        |
| `More` (`⋯`)     | Status history, edit, share, watchers, or module-specific actions |

Detail screens often use horizontal tabs (for example, `Details`, `Attachments`, `Follow-ups`). Lists drill down to a record, then to sub-panels. Deep links from notifications open the target module when your role allows.

Many module home screens show a blue **bell** for notifications. List screens may show a `+` button for create actions when your permissions allow.

## Portfolio sheet and notifications

Swipe up the bottom handle labeled `Portfolio` or `All Sites Overview` from any building screen to return to the map or sites list. You keep your sign-in session and organization.

From the sheet you can open another site, switch to portfolio modules, or [reorder modules](/products/mobile-app/portfolio/portfolio-and-sites#reorder-modules).

Tap the blue **bell** on module home screens and the portfolio map to open `Notifications`. Alerts follow the same policies as KODE OS web for your role. Enable notifications in iOS or Android system settings if you declined the prompt earlier.

## Native screens and web views

| UI type            | Examples                                                                            |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Native**         | Portfolio map, device lists, trends, most module lists and detail tabs              |
| **In-app browser** | Sign-in, organization switcher, some profile links (Knowledge Base, Privacy Policy) |

Web views load `accounts.kodelabs.com` or your identity provider during sign-in and organization switch. Use `Done` or back to return to native navigation.

## Quick reference

| Goal                              | Start here                                                                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Change organization               | [Customize your experience](/products/mobile-app/get-started/customize-experience#switch-organization) → `Switch Organization` |
| Pick another building             | Bottom `Switch Site` or portfolio map                                                                                          |
| Open dashboards or cross-site FDD | Portfolio sheet → module row                                                                                                   |
| Command a point or device         | Launcher → `Devices` or `Points`                                                                                               |
| Triage an event                   | Launcher → `FDD Events`                                                                                                        |
| Field maintenance                 | Launcher → `Work Orders`                                                                                                       |
| Saved equipment                   | Launcher → `Bookmarks`                                                                                                         |

## 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="Customize experience" icon="settings" href="/products/mobile-app/get-started/customize-experience" arrow={true}>
    Manage profile, theme, and organizations.
  </Card>

  <Card title="Mobile app overview" icon="smartphone" href="/products/mobile-app/overview" arrow={true}>
    See how mobile covers KODE OS modules.
  </Card>
</CardGroup>