{"id":26243442,"url":"https://github.com/cap-go/capacitor-home-indicator","last_synced_at":"2026-03-02T13:16:24.252Z","repository":{"id":178757300,"uuid":"662211656","full_name":"Cap-go/capacitor-home-indicator","owner":"Cap-go","description":"Hide and show home button indicator in Capacitor app","archived":false,"fork":false,"pushed_at":"2025-04-12T09:16:45.000Z","size":658,"stargazers_count":1,"open_issues_count":11,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T03:46:55.573Z","etag":null,"topics":["capacitor","capacitor-plugin","ionic"],"latest_commit_sha":null,"homepage":"https://capgo.app","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cap-go.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Cap-go","patreon":null,"open_collective":"capgo","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2023-07-04T15:42:42.000Z","updated_at":"2025-02-09T05:11:26.000Z","dependencies_parsed_at":"2024-01-11T19:15:01.349Z","dependency_job_id":"905fc97f-8e3b-40a5-89cf-e844ef3cc531","html_url":"https://github.com/Cap-go/capacitor-home-indicator","commit_stats":{"total_commits":60,"total_committers":3,"mean_commits":20.0,"dds":0.6333333333333333,"last_synced_commit":"42c6df91cfe36567a0a58b5fd3390745304c039d"},"previous_names":["cap-go/home-indicator","cap-go/capacitor-home-indicator"],"tags_count":98,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-home-indicator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-home-indicator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-home-indicator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-home-indicator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cap-go","download_url":"https://codeload.github.com/Cap-go/capacitor-home-indicator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250441263,"owners_count":21431138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["capacitor","capacitor-plugin","ionic"],"created_at":"2025-03-13T10:18:01.568Z","updated_at":"2026-03-02T13:16:24.246Z","avatar_url":"https://github.com/Cap-go.png","language":"Java","funding_links":["https://github.com/sponsors/Cap-go","https://opencollective.com/capgo"],"categories":[],"sub_categories":[],"readme":"# @capgo/capacitor-home-indicator\n \u003ca href=\"https://capgo.app/\"\u003e\u003cimg src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/\u003e\u003c/a\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch2\u003e\u003ca href=\"https://capgo.app/?ref=plugin_home_indicator\"\u003e ➡️ Get Instant updates for your App with Capgo\u003c/a\u003e\u003c/h2\u003e\n  \u003ch2\u003e\u003ca href=\"https://capgo.app/consulting/?ref=plugin_home_indicator\"\u003e Missing a feature? We’ll build the plugin for you 💪\u003c/a\u003e\u003c/h2\u003e\n\u003c/div\u003e\n\nhide and show home button indicator in Capacitor app\n\n# Android\n\nTo be able to hide the home indicator on Android, you need to\nupdate your `MainActivity.java` file to add the following code:\n\n```java\n// ...\n\nimport android.os.Build;\nimport android.os.Bundle;\n\nimport com.getcapacitor.BridgeActivity;\n\npublic class MainActivity extends BridgeActivity {\n\n\n    void fixSafeArea() {\n        if (Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.R) {\n            getWindow().setDecorFitsSystemWindows(false);\n        }\n    }\n\n    @Override\n    protected void onCreate(Bundle savedInstanceState) {\n        super.onCreate(savedInstanceState);\n        fixSafeArea();\n    }\n    // on resume\n    @Override\n    public void onResume() {\n        super.onResume();\n        fixSafeArea();\n    }\n\n    // on pause\n    @Override\n    public void onPause() {\n        super.onPause();\n        fixSafeArea();\n    }\n}\n```\n\nAnd the update styles.xml to add the following code:\n\n```xml\n        \u003citem name=\"android:statusBarColor\"\u003e\n            @android:color/transparent\n        \u003c/item\u003e\n```\n\n## Documentation\n\nThe most complete doc is available here: https://capgo.app/docs/plugins/home-indicator/\n\n## Compatibility\n\n| Plugin version | Capacitor compatibility | Maintained |\n| -------------- | ----------------------- | ---------- |\n| v8.\\*.\\*       | v8.\\*.\\*                | ✅          |\n| v7.\\*.\\*       | v7.\\*.\\*                | On demand   |\n| v6.\\*.\\*       | v6.\\*.\\*                | ❌          |\n| v5.\\*.\\*       | v5.\\*.\\*                | ❌          |\n\n\u003e **Note:** The major version of this plugin follows the major version of Capacitor. Use the version that matches your Capacitor installation (e.g., plugin v8 for Capacitor 8). Only the latest major version is actively maintained.\n\n## Install\n\n```bash\nbun add @capgo/capacitor-home-indicator\nbunx cap sync\n```\n\n## API\n\n\u003cdocgen-index\u003e\n\n* [`hide()`](#hide)\n* [`show()`](#show)\n* [`isHidden()`](#ishidden)\n* [`getPluginVersion()`](#getpluginversion)\n\n\u003c/docgen-index\u003e\n\n\u003cdocgen-api\u003e\n\u003c!--Update the source file JSDoc comments and rerun docgen to update the docs below--\u003e\n\nCapacitor Home Indicator Plugin for controlling the iOS home indicator visibility.\nThe home indicator is the horizontal bar at the bottom of iOS devices without a physical home button.\n\n### hide()\n\n```typescript\nhide() =\u003e Promise\u003cvoid\u003e\n```\n\nHide the home indicator at the bottom of the screen.\n\nThis visually hides the iOS home indicator bar, providing a more immersive\nfull-screen experience. Users can still swipe up to access home, but the\nindicator will not be visible until they start the gesture.\n\niOS only. Has no effect on Android or web.\n\n**Since:** 0.0.1\n\n--------------------\n\n\n### show()\n\n```typescript\nshow() =\u003e Promise\u003cvoid\u003e\n```\n\nShow the home indicator at the bottom of the screen.\n\nThis restores the default iOS home indicator visibility, making it\nalways visible to the user. This is the default behavior.\n\niOS only. Has no effect on Android or web.\n\n**Since:** 0.0.1\n\n--------------------\n\n\n### isHidden()\n\n```typescript\nisHidden() =\u003e Promise\u003c{ hidden: boolean; }\u003e\n```\n\nCheck whether the home indicator is currently hidden.\n\nReturns the current visibility state of the iOS home indicator.\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;{ hidden: boolean; }\u0026gt;\u003c/code\u003e\n\n**Since:** 0.0.1\n\n--------------------\n\n\n### getPluginVersion()\n\n```typescript\ngetPluginVersion() =\u003e Promise\u003c{ version: string; }\u003e\n```\n\nGet the native Capacitor plugin version.\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;{ version: string; }\u0026gt;\u003c/code\u003e\n\n**Since:** 0.0.1\n\n--------------------\n\n\u003c/docgen-api\u003e\n\n### CSS Variables\n\nYou can use `--safe-area-inset-bottom` to make sure your content is not hidden by the home indicator\nThis variable is injected by the plugin for android.\nIt's useful if you set real fullscreen mode on android.\nwith :\n```java\ngetWindow().setDecorFitsSystemWindows(false);\n```\n\n\n# Credits\n\nThis plugin was created originally for [Kick.com](https://kick.com) by [Capgo](https://capgo.app)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-home-indicator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcap-go%2Fcapacitor-home-indicator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-home-indicator/lists"}