Skip to main content
@capgo/capacitor-home-indicator UI & System Open source

Indicator Capacitor plugin

Hide or show iOS home indicator for fullscreen and immersive app experiences

Install

bun add @capgo/capacitor-home-indicator bunx cap sync
npm, pnpm or yarn
  • npm install @capgo/capacitor-home-indicator
  • pnpm add @capgo/capacitor-home-indicator
  • yarn add @capgo/capacitor-home-indicator

Guide

How to use Indicator in Capacitor

Test on device

Download the Capgo app, then scan the QR code.

Indicator plugin preview QR code

Using @capgo/capacitor-home-indicator

Capacitor Home Indicator Plugin for controlling the iOS home indicator visibility. The home indicator is the horizontal bar at the bottom of iOS devices without a physical home button.

Install

bun add @capgo/capacitor-home-indicator
bunx cap sync

bunx cap sync copies the plugin's native code into your native projects. Run it again after every plugin upgrade.

Import

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

API at a glance

Method Description
hide Hide the home indicator at the bottom of the screen.
show Show the home indicator at the bottom of the screen.
isHidden Check whether the home indicator is currently hidden.

Examples

hide()

Hide the home indicator at the bottom of the screen.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.hide();

show()

Show the home indicator at the bottom of the screen.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

await HomeIndicator.show();

isHidden()

Check whether the home indicator is currently hidden.

import { HomeIndicator } from '@capgo/capacitor-home-indicator';

const { hidden } = await HomeIndicator.isHidden();
if (hidden) {
  console.log('Home indicator is hidden');
} else {
  console.log('Home indicator is visible');
}

Full reference

Keep going from Using @capgo/capacitor-home-indicator

If you are using Using @capgo/capacitor-home-indicator to plan native plugin work, connect it with @capgo/capacitor-home-indicator for the implementation detail in @capgo/capacitor-home-indicator, Getting Started for the implementation detail in Getting Started, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and Adding or Updating Plugins for the implementation detail in Adding or Updating Plugins.

FAQ

Indicator plugin FAQ

How do I install the Indicator plugin in a Capacitor app?

Run "bun add @capgo/capacitor-home-indicator" (or "npm install @capgo/capacitor-home-indicator"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-home-indicator" in your app code.

Does @capgo/capacitor-home-indicator work with React, Vue and Angular?

Yes. Indicator is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-home-indicator support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Is @capgo/capacitor-home-indicator free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-home-indicator/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Can I update code that uses Indicator without an App Store review?

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

Ship Indicator changes without waiting for app review

Once the plugin is in your store build, Capgo live updates push your JavaScript, HTML and CSS changes to users in minutes.

Start with Capgo