edge-to-edge
Use this skill to migrate your Jetpack Compose app to add adaptive edge-to-edge
Install / Use
npx skills add android/skills --skill edge-to-edgeInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Customer SupportSupported Platforms
Tags
Our assessment of edge-to-edge
edge-to-edge scores 93/100 on our quality scale, 88th of 319 Customer Support skills we index (top 28%).
Its SKILL.md is 14 KB long, well organised into 16 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
With 7,514 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so edge-to-edge is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
edge-to-edge compared with similar skills
All 4 of these similar skills score higher than edge-to-edge; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| edge-to-edge (this skill)by android | 93 | 7.5k | 54d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install edge-to-edge?
- Run
npx skills add android/skills --skill edge-to-edge. The install tabs above show the steps for each supported agent. - Which AI agents does edge-to-edge work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is edge-to-edge safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is edge-to-edge still maintained?
- The repository was last updated about 2 months ago, so edge-to-edge is actively maintained.
Skill content
View source on GitHubname: edge-to-edge description: Use this skill to migrate your Jetpack Compose app to add adaptive edge-to-edge support and troubleshoot common issues. Use this skill to fix UI components (like buttons or lists) that are obscured by or overlapping with the navigation bar or status bar, fix IME insets, and fix system bar legibility. license: Complete terms in LICENSE.txt metadata: author: Google LLC last-updated: '2026-08-24' keywords:
- android
- compose
- system bars
- edge-to-edge
- status bar
- navigation bar
Prerequisites
- Project MUST use Android Jetpack Compose.
- Project MUST target SDK 35 or later. If the SDK is lower than 35, increase the SDK to 35.
Step 1: plan
- Locate and analyze all Activity classes to detect which have existing edge-to-edge support. For every Activity without edge-to-edge, plan to make each Activity edge-to-edge.
- In each Activity, Locate and analyze all lists and FAB components to detect which have existing edge-to-edge support. For every component without edge-to-edge support, plan to make each of these components edge-to-edge.
- In each Activity, scan for
TextField,OutlinedTextField, orBasicTextField. If found, then you MUST verify the IME doesn't hide the input field by following the IME section of this skill.
Step 2: add edge-to-edge support
- Add
enableEdgeToEdgebeforesetContentinonCreatein each Activity that does not already callenableEdgeToEdge. - Add
android:windowSoftInputMode="adjustResize"in the AndroidManifest.xml for all Activities that use a soft keyboard.
Step 3: apply insets
-
The app MUST apply system insets, or align content to rulers, so critical UI remains tappable. Choose only one method to avoid double padding:
- PREFERRED: When available, use
Scaffolds and passPaddingValuesto the content lambda.
<br />Scaffold { innerPadding -> // innerPadding accounts for system bars and any Scaffold components LazyColumn( modifier = Modifier .fillMaxSize() .consumeWindowInsets(innerPadding), contentPadding = innerPadding ) { /* Content */ } }-
PREFERRED: When available, use the automatic inset handling or padding modifiers in material components.
- Material 3 Components manages safe areas for its own components, including:
TopAppBarSmallTopAppBarCenterAlignedTopAppBarMediumTopAppBarLargeTopAppBarBottomAppBarModalDrawerSheetDismissibleDrawerSheetPermanentDrawerSheetModalBottomSheetNavigationBarNavigationRail
- For Material 2 Components, use the
windowInsetsparameter to apply insets manually forBottomAppBar,TopAppBarandBottomNavigation. DO NOT apply padding to the parent container; instead, pass insets directly to the App Bar component. Applying padding to the parent container prevents the App Bar background from drawing into the system bar area. For example, forTopAppBar, choose only one of the following options:- PREFERRED:
TopAppBar(windowInsets = AppBarDefaults.topAppBarWindowInsets) TopAppBar(windowInsets = WindowInsets.systemBars.exclude(WindowInsets.navigationBars))TopAppBar(windowInsets = WindowInsets.systemBars.add(WindowInsets.captionBar))
- PREFERRED:
- Material 3 Components manages safe areas for its own components, including:
-
For components outside a Scaffold, use padding modifiers, such as
Modifier.safeDrawingPadding()orModifier.windowInsetsPadding(WindowInsets.safeDrawing).
<br />Box( modifier = Modifier .fillMaxSize() .safeDrawingPadding() ) { Button( onClick = {}, modifier = Modifier.align(Alignment.BottomCenter) ) { Text("Login") } } -
For deeply nested components with excessive padding, use
WindowInsetsRulers(e.g.Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current)). See the IME section for a code sample. -
When you need an element (e.g. a custom header or decorative scrim) to equal the dimensions of a system bar, use inset size modifiers (e.g.
Modifier.windowInsetsTopHeight(WindowInsets.systemBars)). See the Lists section for a code sample.
- PREFERRED: When available, use
Adaptive Scaffolds
NavigationSuiteScaffoldmanages safe areas for its own components, like theNavigationRailorNavigationBar. However, the adaptive scaffolds (e.g.NavigationSuiteScaffold,ListDetailPaneScaffold) don't propagate PaddingValues to their inner contents. You MUST apply insets to individual screens or components (e.g., listcontentPaddingor FAB padding) as described in Step 3 . DO NOT applysafeDrawingPaddingor similar modifiers to theNavigationSuiteScaffoldparent. This clips and prevents an edge-to-edge screen.
IME
- For each Activity with a soft keyboard, check that
android:windowSoftInputMode="adjustResize"is set in the AndroidManifest.xml. DO NOT useSOFT_INPUT_ADJUST_RESIZEbecause it is deprecated. Then, maintain focus on the input field. Choose one:-
- PREFERRED: Add
Modifier.fitInside(WindowInsetsRulers.Ime.current)to the content container. This is preferred overimePadding()because it reduces jank and extra padding caused by forgetting to consume insets upstream in the hierarchy.
- PREFERRED: Add
-
- Add
imePaddingto the content container. The padding modifier MUST be placed beforeModifier.verticalScroll(). Do NOT useModifier.imePadding()if the parent already accounts for the IME withcontentWindowInsets(e.g.contentWindowInsets = WindowInsets.safeDrawing). Doing so will cause double padding.
- Add
-
IMEs with Scaffolds code patterns
RIGHT
RIGHT because contentWindowInsets contains IME insets, which are passed to the
content lambda as innerPadding.
// RIGHT
Scaffold(contentWindowInsets = WindowInsets.safeDrawing) { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.consumeWindowInsets(innerPadding)
.verticalScroll(rememberScrollState())
) { /* Content */ }
}
<br />
RIGHT because fitInside fits the content to the IME insets regardless of
contentWindowInsets.
// RIGHT
Scaffold() { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.consumeWindowInsets(innerPadding)
.fitInside(WindowInsetsRulers.Ime.current)
.verticalScroll(rememberScrollState())
) { /* Content */ }
}
<br />
RIGHT because the default contentWindowInsets does not contain IME insets, and
imePadding() applies IME insets:
// RIGHT
Scaffold() { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.consumeWindowInsets(innerPadding)
.imePadding()
.verticalScroll(rememberScrollState())
) { /* Content */ }
}
<br />
WRONG
WRONG because there will be excess padding when the IME opens. IME insets are
applied twice, once with innerPadding, which contains IME insets from the passed
contentWindowInsets values, and once with imePadding:
// WRONG
Scaffold(contentWindowInsets = WindowInsets.safeDrawing) { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.imePadding()
.verticalScroll(rememberScrollState())
) { /* Content */ }
}
<br />
WRONG because the IME will cover up the content. Scaffold's default
contentWindowInsets does NOT contain IME insets.
// WRONG
Scaffold() { innerPadding ->
Column(
modifier = Modifier
.padding(innerPadding)
.verticalScroll(rememberScrollState())
) { /* Content */ }
}
<br />
IMEs without Scaffolds code patterns
RIGHT
The following code samples WILL NOT cause excessive padding.
// RIGHT
Box(
// Insets consumed
modifier = Modifier.safeDrawingPadding() // or imePadding(), safeContentPadding(), safeGesturesPadding()
) {
Column(
modifier = Modifier.imePadding()
) { /* Content */ }
}
<br />
// RIGHT
Box(
// Insets consumed
modifier = Modifier.windowInsetsPadding(WindowInsets.safeDrawing) // or WindowInsets.ime, WindowInsets.safeContent, WindowInsets.safeGestures
) {
Column(
modifier = Modifier.imePadding()
) { /* Content */ }
}
<br />
// RIGHT
Box(
// Insets not consumed, but irrelevant due to fitInside
modifier = Modifier.padding(WindowInsets.safeDrawing.asPaddingValues()) // or WindowInsets.ime.asPaddingValues(), WindowInsets.safeContent.asPaddingValues(), WindowInsets.safeGestures.asPaddingValues()
) {
Column(
modifier = Modifier
.fillMaxSize()
.fitInside(WindowInsetsRulers.Ime.current)
) { /* Content */ }
}
<br />
WRONG
The following code sample WILL cause excessive padding because IME insets are applied twice:
// WRONG
Box(
// Insets not consumed
modifier = Modifier.padding(WindowInsets.safeDrawing.asPaddingValues()) // or WindowInsets.ime.asPaddingValues(), WindowInsets.safeContent.asPaddingValues(), WindowInsets.safeGestures.asPaddingValues()
) {
Column(
modifier = Modifier.imePadding()
) { /* Content */ }
}
<br />
Navigation Bar Contrast & System Bar Icons
-
If the Activity uses
enableEdgeToEdgefromWindowCompat, you MUST setisAppearanceLightNavigationBarsandisAppearanceLightStatusBarsto the inverse of the device theme for apps that support light and dark theme so the system bar icons are legible. It's recommended to do this in your theme file. DO NOT do this if the Activities useenableEdgeToEdgefromComponentActivitybecause it handles the icon colors automatically.
<br />// Only use if calling `enableEdgeToEdge` from `WindowCompat`. // Apply to your theme file. @Composable fun MyTheme( darkTheme: Boolean = isSystemInDarkTheme(), content: @Composable () -> Unit ) { val view = LocalView.current if (!view.isInEditMode) { SideEffect { val window = (view.context as? Activity)?.window ?: return@SideEffect val controller = WindowCompat.getInsetsController(window, view) // Dark icons for Light Mode (!darkTheme), Light icons for Dark Mode controller.isAppearanceLightStatusBars = !darkTheme controller.isAppearanceLightNavigationBars = !darkTheme } } MaterialTheme(content = content) } -
If any screen uses a
Scaffoldor aNavigationSuiteScaffoldwith a bottom bar (e.g.,BottomAppBar,NavigationBar), setwindow.isNavigationBarContrastEnforced = falsein the corresponding Activity for SDK 29+. This prevents the system from adding a translucent background to the navigation bar, verifying your bottom bar colors extend to the bottom of the screen.
Lists
- Apply inset padding (like
Scaffold'sinnerPadding) to thecontentPaddingparameter of scrollable components (e.g.LazyColumn,LazyRow). DO NOT apply it as aModifier.padding()to the list's parent container, as this clips the content and prevents it from scrolling behind the system bars. - Create a translucent composable covering the system bar so that the icons are still legible.
class SystemBarProtectionSnippets : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// enableEdgeToEdge sets window.isNavigationBarContrastEnforced = true
// which is used to add a translucen
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
