building-storefronts

Frontend integration guide for building storefronts with Medusa. Covers SDK usage, React Query patterns, and calling custom API routes. Load this skill for ANY storefront development task, including: Also load building-with-medusa when: Building the backend API routes that the storefront calls The quick reference below is NOT sufficient for implementation. You MUST load the reference file before writing storefront integration code. Load this reference when implementing storefront features: ALWAYS pass plain objects to the SDK - NEVER use JSON.stringify(): Why this matters: Before implementing, verify you're NOT doing these: SDK Usage: React Query: Data Display: Error Handling: For detailed patterns and examples, load reference file: The reference file contains: Use this skill for (PRIMARY SOURCE): Use MedusaDocs MCP server for (SECONDARY SOURCE): Why skills come first: ⚠️ CRITICAL: ALWAYS use the Medusa JS SDK - NEVER use regular fetch() When building features that span backend and frontend: Why the SDK is required: See building-with-medusa for backend API route patterns. - Calling custom Medusa API routes from the storefront - Integrating Medusa SDK in frontend applications - Using React Query for data fetching - Implementing mutations with optimistic updates - Error handling and cache invalidation - Calling API routes? → MUST load references/frontend-integration.md first -...