commercetools-merchant-center

Production-tested patterns for commercetools Merchant Center custom applications, custom views, UI Kit, and deployment from a Platinum partner with 50+ live implementations.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "commercetools-merchant-center" with this command: npx skills add ariessolutionsio/composable-skills/ariessolutionsio-composable-skills-commercetools-merchant-center

commercetools Merchant Center Customization Development

Progressive loading — only load what you need:

  • Building a Custom Application? Load references/custom-applications.md
  • Building a Custom View? Load references/custom-views.md
  • Working with data fetching or external API proxying? Load references/ui-data-fetching.md
  • Working with forms, routing, or UI Kit components? Load references/ui-forms-components.md
  • Deploying or testing? Load references/deployment.md

CRITICAL Priority -- Architectural Decisions

PatternFileImpact
Custom Application vs Custom Viewreferences/custom-applications.mdWrong choice means rebuilding from scratch. Applications are full pages; Views are embedded panels.
Application Shell & Entry Point Configreferences/custom-applications.mdMisconfigured entryPointUriPath or cloudIdentifier blocks all development. Reserved paths silently fail.
OAuth Scopes & Permission Modelreferences/custom-applications.mdMissing scopes cause 403 errors in production. Over-scoping violates least privilege. Team assignment is required.

HIGH Priority -- Development Patterns

PatternFileImpact
Custom View Panel Types & Locatorsreferences/custom-views.mdWrong panel size or locator means content does not display where users expect it.
Data Fetching with useMcQueryreferences/ui-data-fetching.mdUsing raw Apollo without MC context breaks authentication. Must use GRAPHQL_TARGETS.
Forward-To Proxy for External APIsreferences/ui-data-fetching.mdCustom API integration requires /proxy/forward-to with JWT validation. Direct calls from the browser fail.
Form Patterns with Formikreferences/ui-forms-components.mdMC SDK fields expect Formik integration. Raw form state causes validation and accessibility gaps.
Routing & Navigationreferences/ui-forms-components.mdMust use useRouteMatch for nested routes. Hardcoded paths break across projects.
UI Kit Components & Design Systemreferences/ui-forms-components.mdIgnoring ui-kit produces inconsistent UX and fails design review.

MEDIUM Priority -- Deployment & Operations

PatternFileImpact
Deployment to Vercel / Netlifyreferences/deployment.mdMissing SPA rewrites cause 404s. Wrong build command skips MC compilation.
Deployment to commercetools Connectreferences/deployment.mdconnect.yaml misconfiguration blocks deployment. APPLICATION_URL is auto-provided.
Application Registration & Statesreferences/deployment.mdForgetting to move from Draft to Ready means the app cannot be installed.
Testing Custom Applicationsreferences/deployment.mdMC-specific test utilities required for permission and context mocking.

Common Anti-Patterns (Quick Reference)

Anti-PatternFileConsequence
Using raw Apollo instead of useMcQueryreferences/ui-data-fetching.mdBreaks MC authentication context
Calling external APIs directly from browserreferences/ui-data-fetching.mdCORS failures, bypassed auth -- use Forward-To proxy
Using raw React state instead of Formikreferences/ui-forms-components.mdValidation and accessibility gaps with MC fields
Using ApplicationShell in a Custom Viewreferences/custom-views.mdWrong shell -- Custom Views require CustomViewShell
Reserved or hardcoded entryPointUriPathreferences/custom-applications.mdApplication silently fails to load
Forgetting Draft-to-Ready state transitionreferences/deployment.mdApp appears registered but cannot be installed

Decision Flowchart: Custom Application or Custom View?

Does the functionality need its own page and main menu entry?
  YES --> Custom Application
  NO  --> Continue

Does the functionality enhance an EXISTING built-in MC page?
  (e.g., extra details on an Order, Customer, or Product page)
  YES --> Custom View
  NO  --> Continue

Does the functionality require complex multi-page navigation?
  (e.g., list page, detail page, create/edit forms)
  YES --> Custom Application
  NO  --> Continue

Is the functionality a simple panel showing contextual info or actions?
  (e.g., order tracking, loyalty points, quick edits)
  YES --> Custom View (narrow or extended panel)
  NO  --> Custom Application (default choice for standalone features)

MCP Complement

Use this skill to DESIGN and STRUCTURE your MC extension, then use the Developer MCP for MC SDK docs and the Commerce MCP for CRUD operations.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

commercetools-data

No summary provided by upstream source.

Repository SourceNeeds Review
8-ariessolutionsio
General

commercetools-api

No summary provided by upstream source.

Repository SourceNeeds Review
8-ariessolutionsio
General

commercetools-frontend

No summary provided by upstream source.

Repository SourceNeeds Review
6-ariessolutionsio
General

image-gen

Generate AI images from text prompts. Triggers on: "生成图片", "画一张", "AI图", "generate image", "配图", "create picture", "draw", "visualize", "generate an image".

Archived SourceRecently Updated
--0xfango