medusajs/construção-de-lojas

O que construção-de-lojas faz?

Carregar automaticamente ao planejar, pesquisar ou implementar recursos de loja Medusa (chamada de rotas de API personalizadas, integração SDK, padrões React Query, busca de dados). OBRIGATÓRIO para todo desenvolvimento de loja em TODOS os modos (planejamento, implementação, exploração). Contém padrões de uso do SDK, integração frontend e regras críticas para chamar APIs Medusa.

Visão Geral

Esta habilidade central é ativada automaticamente sempre que você estiver envolvido em tarefas relacionadas a desenvolvimento de frontend de loja Medusa. Ela fornece diretrizes essenciais, padrões de código e melhores práticas para:

• Chamar rotas de API personalizadas do Medusa
• Integrar o SDK do Medusa no frontend
• Utilizar React Query para gerenciamento de estado e busca de dados
• Estruturar componentes e páginas de forma eficiente

Quando Usar

• Planejamento: Ao definir a arquitetura de frontend, componentes e fluxos de dados
• Implementação: Durante a codificação de telas, integrações e lógica de negócio
• Exploração: Para entender padrões existentes, depurar problemas ou aprender novas funcionalidades

Plataformas Suportadas

• Claude Code
• Cursor
• Codex

Conteúdo

Uso do SDK Medusa

import Medusa from "@medusajs/medusa-js"

const medusa = new Medusa({ baseUrl: "http://localhost:9000", maxRetries: 3 })

// Exemplo de chamada de produto
medusa.products.list().then(({ products }) => {
  console.log(products)
})

Integração com React Query

import { useQuery } from "@tanstack/react-query"

const useProducts = () => {
  return useQuery({
    queryKey: ["products"],
    queryFn: () => medusa.products.list(),
  })
}

Chamada de Rotas de API Personalizadas

const { data } = await medusa.client.request("GET", "/store/custom-endpoint")

Regras Críticas

1. Sempre use o SDK do Medusa para chamadas de API quando disponível
2. Utilize React Query para gerenciamento de cache e estado assíncrono
3. Nunca chame APIs Medusa diretamente sem tratamento de erros
4. Mantenha a separação de responsabilidades entre componentes e lógica de dados

---

Documentação traduzida para português para facilitar o desenvolvimento de lojas Medusa.