Commerce & storefronts

Medusa

Plataforma de comércio open-source com um framework de customização embutido — primitivas de comércio que você monta em uma loja, marketplace ou portal B2B

medusajs/medusaTypeScript35,295 as of 2026-07-23
By Jake Luo · Published 23 de jul. de 2026

Medusa é uma plataforma de comércio open-source escrita em TypeScript. Em vez de um produto de loja fixo, ela te dá as primitivas de comércio — carrinhos, pedidos, precificação, cumprimento de pedidos — mais um framework para customizá-las, para que você construa uma loja DTC, um portal B2B, um marketplace ou um sistema de ponto de venda sem reinventar essa lógica. É licenciada sob MIT, os módulos são publicados no npm, e existe uma opção paga gerenciada caso você prefira não hospedar por conta própria. O jeito útil de enquadrar isso para um fundador é que a Medusa resolve a metade do comércio que tem uma definição de pronto. Fazer as pessoas chegarem à loja, e voltarem uma segunda vez, não tem essa definição.

O que é a Medusa

A Medusa (github.com/medusajs/medusa) se descreve como blocos de construção para comércio digital: uma plataforma com um framework embutido de customização que permite construir aplicações de comércio sem reinventar a lógica central do comércio. Na prática, isso significa que os modelos de carrinho, pedido, precificação e cumprimento de pedidos chegam como módulos que você estende, em vez de um template com o qual você tem que brigar. O README do projeto nomeia o público-alvo — lojas B2B ou DTC avançadas, marketplaces, plataformas de distribuidores, sistemas de ponto de venda e negócios de serviço — o que é um bom sinal de para quem ela serve: times cujo modelo de comércio não cabe no formato que um construtor de lojas hospedado assume.

O licenciamento é refrescantemente simples depois de uma sequência de projetos source-available. A Medusa é licenciada sob MIT e seus módulos de comércio são open source e disponíveis gratuitamente no npm, então auto-hospedar custa infraestrutura e tempo, não software. O projeto está em desenvolvimento contínuo desde 2020, é escrito em TypeScript de ponta a ponta, e oferece a Medusa Cloud como um ambiente gerenciado pago para times que preferem não rodar implantação e escalonamento por conta própria. Seu Discord lista mais de 14.000 membros na comunidade, o que importa principalmente porque um stack de comércio é algo sobre o qual você vai ter dúvidas em horários incômodos.

Onde a Medusa se encaixa na stack de crescimento de um fundador

Fundadores de comércio têm um problema quase oposto ao dos fundadores de SaaS. Um fundador de SaaS passa meses fazendo o produto fazer a tal coisa; uma loja pode estar de pé, estilizada e recebendo pagamentos em um fim de semana. O que essa velocidade esconde é que a loja nunca foi o recurso escasso — a demanda era. A Medusa se encaixa exatamente na metade que dá para construir:

  • Ela é dona da transação — catálogo, carrinho, checkout, pedidos, devoluções e a administração ao redor deles, em código que você controla, em vez de um tema que você remenda.
  • Ela absorve lógica de comércio incomum — tabelas de preço B2B, divisões de marketplace, pedidos no formato de assinatura. Esse é o motivo real pelo qual times abandonam plataformas hospedadas, e a razão pela qual um framework vence um template aqui.
  • Ela deixa o front-end com você — headless por design, então a loja é uma aplicação web normal que você pode otimizar para velocidade e busca, em vez de um template com controle limitado sobre o markup.
  • Ela não toca em aquisição — nada no repositório tem uma opinião sobre quem deveria estar no site, o que essas pessoas deveriam ler primeiro, ou por que elas voltariam no mês seguinte.

Esse último ponto é onde a maioria dos projetos de comércio empaca. A construção tem uma linha de chegada visível e o trabalho de crescimento não, então o trabalho que tem uma definição de pronto absorve a atenção. Se você está nessa fase, a pergunta mais valiosa é com quais canais um novo negócio deveria começar e como transformar o tráfego que chega em pedidos — veja transformar visitantes em cadastros, que se aplica igualzinho a um checkout.

O que a Medusa não faz — e com o que combiná-la

O que a plataforma te dá, e o que ela não dá
  • Te dá: carrinhos, pedidos, precificação, cumprimento de pedidos e a administração ao redor deles, customizáveis sem fazer fork do projeto.
  • Não te dá: um motivo para alguém chegar até você. Posicionamento, canais e os primeiros cem pedidos vivem todos fora da base de código.
  • Não te dá: recompra. Retenção é um problema de e-mail, suporte e produto muito antes de ser um problema de plataforma.
  • Não te dá: a decisão do que vender e para quem — a escolha que determina se algo do que vem acima importa.

Nota em primeira mão: a AgentCeres — o Diretor de Crescimento com IA em agentceres.com — não roda uma loja, mas enfrentamos o mesmo formato de problema e tiramos a mesma lição. Nosso billing, planos e checkout eram uma tarefa de engenharia com limites claros: foi lançado, e depois praticamente parou de precisar de nós. A metade em aberto — fazer as pessoas certas olharem para a página, e dar a elas um motivo para voltar — nunca ficou pronta de vez. Nossos agentes leem de conectores que incluem Stripe e os feeds de vendas das app stores, e as perguntas que movem esses números quase nunca são perguntas sobre o checkout. Se a sua lógica de comércio é a parte difícil, a Medusa é uma boa escolha. Se a parte difícil é que ninguém está chegando, esse é um trabalho diferente, e é o que nossos especialistas de pesquisa e SEO redigem — com uma pessoa aprovando qualquer coisa que sai em seu nome.

FAQ

A Medusa é gratuita?
Sim, no sentido direto. A Medusa é licenciada sob MIT e seus módulos de comércio são open source e disponíveis no npm, então não há custo de software nem restrição para construir um produto comercial com ela. O que você paga é infraestrutura e o tempo de engenharia para rodá-la — banco de dados, hospedagem, atualizações. A Medusa Cloud é a opção paga e gerenciada do projeto, que troca esse trabalho operacional por uma conta a pagar.
Medusa vs Shopify — o que um fundador deveria escolher?
Elas otimizam para restrições diferentes, e a resposta honesta geralmente favorece a opção hospedada no começo. O Shopify coloca uma loja convencional vendendo nesta semana sem precisar de engenheiro, e seu ecossistema cobre a maioria das necessidades padrão. A Medusa vence quando o seu modelo de comércio é a parte incomum — regras de preço B2B, repasses de marketplace, um checkout sob medida — ou quando você quer ser dono do stack por completo. Se você ainda não consegue nomear a coisa específica que uma plataforma hospedada te impede de fazer, provavelmente você ainda não precisa do framework.
Preciso de um desenvolvedor para usar a Medusa?
Sim. A Medusa é um framework e um conjunto de módulos, não um construtor de lojas hospedado com editor visual, então colocá-la de pé e construir a loja é trabalho de desenvolvimento. Essa é a troca feita: você aceita esforço de engenharia em troca de controle sobre a lógica de comércio que plataformas hospedadas mantêm fixa. Times sem um desenvolvedor quase sempre são melhor atendidos por uma loja hospedada até que as limitações dela comecem a incomodar.
Related projects
PolarFaturamento de código aberto como merchant of record para desenvolvedores — preços por uso, assinaturas e impostos mundiais cuidados por vocêDubOpen-source link management and attribution for modern marketing teamsOpen SaaSUm boilerplate de SaaS gratuito e de código aberto, construído sobre o framework full-stack Wasp

You built it. Now grow it.

AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $19/month.

Start free trialMore projects