Shopify Polaris App Home

Name: Shopify Polaris App Home
Author: shopify

shopify/shopify-ai-toolkit

Build or refactor the embedded App Home experience in Shopify Admin using Polaris patterns and aligned Admin API versions from the toolkit.

Overview

shopify-polaris-app-home is an agent skill for the Build phase that guides Polaris App Home UI and version-aligned Shopify Admin APIs for embedded apps.

Install

npx skills add https://github.com/shopify/shopify-ai-toolkit --skill shopify-polaris-app-home

What is this skill?

Shopify AI toolkit skill focused on Polaris App Home for embedded admin apps
Documents multiple API surfaces—admin, storefront GraphQL, partner, customer, and payments-apps—with dated releases
Pins latest stable admin API context (e.g., 2026-04 as latestVersion in the bundled manifest)
Helps avoid drifting to unsupported unstable-only APIs when scaffolding app home UI
Pairs with Shopify’s embedded app model rather than standalone SaaS dashboards
5 API surface groups in version manifest (admin, storefront-graphql, partner, customer, payments-apps)

Compatible agents: Claude Code, Cursor, Codex, any compatible agent

Adoption & trust: 5k installs on skills.sh; 373 GitHub stars; 2/3 security scanners passed (skills.sh audits).

What problem does it solve?

You are building a Shopify embedded app home screen but struggle to match Polaris patterns and pick the correct Admin API version across Shopify’s dated releases.

Who is it for?

Solo developers shipping a Shopify App Store embedded app who want the agent to follow official Polaris app-home constraints and API calendars.

Skip if: Custom storefront themes only, headless storefronts with no embedded admin UI, or merchants who never touch the Partner developer stack.

When should I use this skill?

Building or updating the embedded Shopify Admin App Home UI with Polaris and versioned Admin/GraphQL APIs.

What do I get? / Deliverables

You implement App Home UI that follows toolkit Polaris guidance and targets supported API versions for admin and related Shopify surfaces.

App Home UI structure aligned to Polaris
API version choices documented for admin-related calls

Recommended Skills

Frontend Designanthropics/skills

Frontend Design is an agent skill for solo and indie builders who want web interfaces that look intentional, not like ev…516k installs·148k stars

Vercel React Best Practicesvercel-labs/agent-skills

Vercel React Best Practices is an agent skill packaging Vercel Engineering’s performance playbook for React and Next.js.…459k installs·27.7k stars

Remotion Best Practicesremotion-dev/skills

Remotion Best Practices is a domain knowledge agent skill for solo and indie builders who ship video with Remotion—progr…357k installs·3.5k stars

Vercel Composition Patternsvercel-labs/agent-skills

Vercel Composition Patterns is an agent-oriented skill from Vercel Labs that documents how solo and indie builders shoul…204k installs·27.7k stars

Develop Userscriptsxixu-me/skills

Guides building and fixing browser userscripts for Tampermonkey and ScriptCat, emphasizing runtime selection, minimal pe…154k installs·61 stars

Next Best Practicesvercel-labs/next-skills

Next Best Practices is a Vercel Labs agent skill that encodes how to write and review modern Next.js App Router projects…102k installs·919 stars

Journey fit

Primary fit

BuildUI/UX & frontend

Build is where embedded Shopify apps take shape; this skill targets the admin home surface merchants see after install. Frontend fits Polaris UI composition, layout, and versioned admin extension APIs rather than checkout or storefront theme work.

How it compares

Shopify-specific Polaris app-home skill—not a generic React component library or Theme App Extension workflow.

Common Questions / FAQ

Who is shopify-polaris-app-home for?

Indie and solo Shopify app developers using AI coding agents to build the embedded Admin home experience with Polaris.

When should I use shopify-polaris-app-home?

During Build while scaffolding App Home layouts, settings, and data hooks tied to Admin GraphQL versions before Ship and app review.

Is shopify-polaris-app-home safe to install?

It is documentation-oriented from Shopify’s toolkit; review the Security Audits panel on this page and follow Shopify’s OAuth and secret-handling practices in your app.

SKILL.md

READMESKILL.md - Shopify Polaris App Home

{
  "admin": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "storefront-graphql": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "partner": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "customer": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "payments-apps": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-app-home": [],
  "polaris-admin-extensions": [
    {
      "name": "2026-04",
      "releaseCandidate": true
    },
    {
      "name": "2026-01",
      "latestVersion": true
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-checkout-extensions": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-customer-account-extensions": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "pos-ui": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "hydrogen": [
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "storefront-web-components": [],
  "functions_cart_checkout_validation": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_cart_transform": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_delivery_customization": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_discount": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {

What is this skill?

Shopify AI toolkit skill focused on Polaris App Home for embedded admin apps

Documents multiple API surfaces—admin, storefront GraphQL, partner, customer, and payments-apps—with dated releases

Pins latest stable admin API context (e.g., 2026-04 as latestVersion in the bundled manifest)

Helps avoid drifting to unsupported unstable-only APIs when scaffolding app home UI

Pairs with Shopify’s embedded app model rather than standalone SaaS dashboards

5 API surface groups in version manifest (admin, storefront-graphql, partner, customer, payments-apps)

Compatible agents: Claude Code, Cursor, Codex, any compatible agent

Adoption & trust: 5k installs on skills.sh; 373 GitHub stars; 2/3 security scanners passed (skills.sh audits).

Journey fit

Primary fit

BuildUI/UX & frontend

SKILL.md

READMESKILL.md - Shopify Polaris App Home

{
  "admin": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "storefront-graphql": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "partner": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "customer": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "payments-apps": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-app-home": [],
  "polaris-admin-extensions": [
    {
      "name": "2026-04",
      "releaseCandidate": true
    },
    {
      "name": "2026-01",
      "latestVersion": true
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-checkout-extensions": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "polaris-customer-account-extensions": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "pos-ui": [
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "hydrogen": [
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "storefront-web-components": [],
  "functions_cart_checkout_validation": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_cart_transform": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_delivery_customization": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {
      "name": "2026-04",
      "latestVersion": true
    },
    {
      "name": "2026-01"
    },
    {
      "name": "2025-10"
    },
    {
      "name": "2025-07"
    }
  ],
  "functions_discount": [
    {
      "name": "unstable"
    },
    {
      "name": "2026-07",
      "releaseCandidate": true
    },
    {

Overview

Install

What is this skill?

What problem does it solve?

Who is it for?

When should I use this skill?

What do I get? / Deliverables

Recommended Skills

Journey fit

Who is shopify-polaris-app-home for?

When should I use shopify-polaris-app-home?

Is shopify-polaris-app-home safe to install?

SKILL.md

This week for builders

Overview

Install

What is this skill?

What problem does it solve?

Who is it for?

When should I use this skill?

What do I get? / Deliverables

Recommended Skills

Journey fit

Who is shopify-polaris-app-home for?

When should I use shopify-polaris-app-home?

Is shopify-polaris-app-home safe to install?

SKILL.md