Polaris App Home — Page Patterns

Index of Shopify-documented templates (full-page layouts) and compositions (multi-component recipes built from <s-*> web components) on the Polaris App Home surface. Each entry below carries the structural skeleton, intent, and anti-patterns so the agent can scaffold without a fetch round-trip; consult shopify-dev-mcp only for full canonical examples or details beyond the skeleton.

When to use

YES: Scaffolding a new full page in an Admin App Home app (Homepage, Index, Details, Settings). YES: A task names or implies a known composition pattern (Empty state, Setup guide, Callout card, Metrics card, Resource list, etc.). NO: Component-level work — use polaris-app-home-web-components. NO: API-level work (toast, modal, save bar) — use polaris-app-home-app-bridge.

Instructions

1. Match the task to a Template or Composition below; use the listed skeleton as a starting point.
2. For canonical detail beyond the skeleton, route through shopify-dev-mcp → search_docs_chunks with api_name: "polaris-app-home" and the pattern name as the prompt (e.g., "Settings template", "Setup guide composition").
3. Implement using the Polaris components from polaris-app-home-web-components and APIs from polaris-app-home-app-bridge. Combine with the Common Composition Idioms for cross-pattern building blocks.

4. Validate the resulting markup via shopify-dev-mcp → validate_component_codeblocks with api: "polaris-app-home". If validation fails twice on the same artifact, stop and surface the error via the AskUserQuestion tool with options: "Retry with hints", "Skip validation", "Abort". Recommended: "Retry with hints".