skills/ android/skills

glance-canonical-layouts

Use this skill to create home screen widgets using Jetpack Glance Canonical

GitHub stars
7.8K
Installs
New
Files scanned
1
Scan passedknowledge
Source on GitHub

Security scan

Scan passed

No risky patterns were found in the scanned files.

1 files scannedscanner v1.2.0Oct 14, 2026

Content sha256 ae9a588a61e6c038… — run codexguild_scan_skills after installing to verify your local copy.

Static analysis is a first line of defense, not a guarantee. Read the source

SKILL.md

exact scanned copy

To implement a widget Canonical Layout that follows the recommended design patterns:

  1. The project MUST use Jetpack Glance.
  2. You MUST locate the requested layout from the list under Canonical Layout Reference Files.
  3. Copy the layout reference files into your project's target app module (e.g., src/main/java/ and src/main/res/) in one step to implement the exact design and reduce the number of tool calls.
  4. You MUST set override val sizeMode: SizeMode = SizeMode.Exact in the widget provider class.
  5. Validate that your project compiles, updating sample package declarations, import paths, and class names to match the target app's package name.
  6. Clean your project's widget code, removing unused classes (for example, unused buttons).
  7. You MUST register the widget receiver in AndroidManifest.xml inside <application> after <activity>, ensuring android:resource="@xml/..." matches the filename of the copied Widget Info XML. Otherwise, the widget won't appear in the widget picker:
<receiver android:name=".glance.MyReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data
        android:name="android.appwidget.provider"
        android:resource="@xml/my_app_widget_info" />
</receiver>

Dependencies

Add Jetpack Glance dependencies to the app module's build.gradle.kts (dependencies block):

  • androidx.glance:glance-appwidget:1.2.0 or higher
  • androidx.glance:glance-material3:1.2.0 or higher
  • androidx.glance:glance-appwidget-preview:1.2.0 or higher
  • androidx.glance:glance-preview:1.2.0 or higher

Use version 1.3.0-alpha02 or higher with compileSdk = 37 and Android Gradle Plugin (AGP) 9.1.0 or higher (for example, agp = "9.1.0" in gradle/libs.versions.toml) when implementing Snap Scrolling.

If copying sample data repositories that load bitmaps with Coil (such as FakeImageGridDataRepository.kt, FakeImageTextListDataRepository.kt, or FakeTextWithImageRepository.kt), also add an image loading library dependency such as io.coil-kt:coil (e.g., implementation("io.coil-kt:coil:2.7.0")) if one doesn't already exist.

Canonical layout reference files

Action list layout (action_list)

Check list layout (check_list)

Expressive toolbar layout (expressive_toolbar)

Image grid layout (image_grid)

Image text list layout (image_text_list)

Long text layout (long_text)

Search toolbar layout (search_toolbar)

Full-bleed image layout and snap scrolling (snap_scrolling)

Standard toolbar layout (standard_toolbar)

Text with image layout (text_with_image)

Troubleshooting

  1. Background Colors : Use GlanceModifier.background(Color) directly for solid background colors rather than ColorProvider, otherwise the background will be transparent.
  2. When using ColorProvider (outside of the background), avoid import errors :
    1. Import type: import androidx.glance.unit.ColorProvider
    2. Use fully qualified creator: androidx.glance.color.ColorProvider(dayColor, nightColor)

Checklist

  • [ ] Did you register the widget in the AndroidManifest?
  • [ ] Did you copy the corresponding Widget Info XML file and leave the given values including minWidth, minHeight, and minResizeHeight unchanged?
  • [ ] Did you use the given Glance Theme color values from the corresponding Layout Composable file?
  • [ ] Did you use dimension resource references for android:minWidth and android:minHeight in appwidget-provider XML definitions?
  • [ ] Did you override val sizeMode: SizeMode = SizeMode.Exact in the widget provider class?

Files

1
23.9 KB

Agent reviews

0

No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.

More from android/skills8

adaptive

Instructions to make or update an app's UI so that it adapts to different

Scan passed 7.8KNew
agp-9-upgrade

Upgrades, or migrates, an Android project to use Android Gradle Plugin

Scan passed 7.8KNew
android-cli

Provides instructions for installing and using the `android` CLI. The

Flagged 7.8KNew
android-for-cars-parked-apps

Adapt existing Android video streaming apps, games, and web browsers

Scan passed 7.8KNew
android-intent-security

Best practices for Android Intent security. Use this skill when auditing

Scan passed 7.8KNew
android-permissions-security

Audits, detects gaps, and remediates Android permissions and IPC component

Flagged 7.8KNew
android-profiler

Records and analyzes Android performance data and diagnoses performance

Flagged 7.8KNew
appfunctions

Analyzes Android apps to identify key user workflows for AppFunctions

Scan passed 7.8KNew

Related knowledge skillsscan passed

qdrant-scaling-qps

Guides Qdrant query throughput (QPS) scaling. Use when someone asks 'how to increase QPS', 'need more throughput', 'queries per second too low', 'batch search', 'read replicas', or 'how to handle more concurrent queries'.

Scan passed 257New
gke-workload-scaling-troubleshooting

Diagnoses GKE HorizontalPodAutoscaler (HPA) failures — metrics showing as <unknown>, FailedGetResourceMetric / FailedGetScale / FailedComputeMetricsReplicas events, missing Pod resource requests, custom/external metrics-pipeline breakage (FailedGetExternalMetric / FailedGetCustomMetric, unavailable

Scan passed 21.3KNew
solo

Work on one hard mathematics problem in this session yourself, with no sub-agents: reason in stages, record each settled step in a notes file so that nothing written is lost if a response is cut off, and end with a self-contained proof.md. Usage: /math-proof:solo <the problem, stated in full, or the

Scan passed 38KNew
error-tracking-nuxt

PostHog error tracking for Nuxt

Scan passed 74New
semgrep-rule-variant-creator

Creates language variants of existing Semgrep rules. Use when porting a Semgrep rule to specified target languages. Takes an existing rule and target languages as input, produces independent rule+test directories for each language.

Scan passed 7.5KNew