---
title: "isStandaloneMode"
description: "Check whether the app is running as an installed Progressive Web App (PWA) rather than inside a browser tab."
package: "@maz-ui/utils"
url: "https://maz-ui.com/ecosystem/utils/is-standalone-mode"
---

# isStandaloneMode

> Check whether the app is running as an installed Progressive Web App (PWA) rather than inside a browser tab.

- Package: `@maz-ui/utils`
- Import: `import { isStandaloneMode } from '@maz-ui/utils/helpers/isStandaloneMode'`
- Web: https://maz-ui.com/ecosystem/utils/is-standalone-mode

## Usage

```ts
import { isStandaloneMode } from '@maz-ui/utils'

if (isStandaloneMode()) {
  console.log('Running as installed PWA')
}
```

## API

```ts
function isStandaloneMode(): boolean
```

Returns `true` if the page is rendered in standalone display mode, `false` otherwise (including during SSR).

## Detection rules

The check returns `true` when **either**:

- `window.matchMedia('(display-mode: standalone)').matches` - covers Chrome, Edge, Firefox, etc.
- `navigator.standalone` is truthy - iOS Safari's legacy property.

## Examples

Hide install prompts when already installed:

```ts
if (!isStandaloneMode()) {
  showInstallBanner()
}
```