Sumário
Desenvolvedores que criam aplicativos Shopify geralmente recorrem ao Shopify CLI porque estão cansados de:
- Fazer manualmente o scaffolding de boilerplate de aplicativo, fluxos OAuth e subscrições de webhook do zero
- Clicar no Painel de Parceiros para criar e configurar cada aplicativo de teste
- Implantar extensões com scripts frágeis e feitos à mão
- Esperar para ver as alterações porque não há um loop de desenvolvimento local com hot reload
O Shopify CLI resolve todos os quatro. Ele faz o scaffolding de um aplicativo, o executa localmente em uma loja de desenvolvimento com um túnel seguro e implanta extensões de aplicativo do seu terminal.
Shopify CLI via publicação no LinkedIn de Taylor Page
O que é o Shopify CLI
O Shopify CLI é a ferramenta oficial de linha de comando da Shopify para criar aplicativos, temas e storefronts personalizados. Para desenvolvedores de aplicativos, ele lida com quatro coisas: scaffolding de projeto (com modelos para Remix e outras pilhas), desenvolvimento local com tunelamento automático para uma loja de desenvolvimento, gerenciamento de ambiente e segredos, e implantação de configuração e extensões de aplicativos.
Instalando o CLI
O CLI é executado em macOS, Windows e Linux e requer uma versão recente do Node.js LTS. Instale-o globalmente com npm:
npm install -g @shopify/cli@latest
Verifique a instalação com shopify version. Você também vai querer um conta de Parceiro Shopify e uma loja de desenvolvimento para testar.
Criando um novo aplicativo
Faça o scaffolding de um novo projeto de aplicativo:
shopify app init
O CLI solicita um nome de projeto e um modelo, depois gera um esqueleto de aplicativo funcional (OAuth, armazenamento de sessão e fiação de webhook inclusos), conectado à sua organização de Parceiros.
Fluxo de trabalho de desenvolvimento local
Do seu diretório de projeto:
shopify app dev
Isso inicia um servidor local, abre um túnel para que sua loja de desenvolvimento possa alcançá-lo e faz hot-reload conforme você edita. Instale a visualização em sua loja de desenvolvimento e você estará iterando em APIs reais do Shopify em minutos, não em dias.
Implantando seu aplicativo
Quando estiver pronto para enviar configuração e extensões:
shopify app deploy
Isso envia uma versão do aplicativo para a Shopify. A partir daí, a distribuição ocorre através do Painel de Parceiros — aplicativos públicos através do processo de análise da Shopify App Store, aplicativos personalizados diretamente para um lojista.
Armadilhas comuns (e como evitá-las)
Quatro coisas atrapalham a maioria dos primeiros aplicativos:
Túneis e VPNs: shopify app dev abre um túnel para sua loja de desenvolvimento, e VPNs corporativas ou firewalls rigorosos podem quebrá-lo silenciosamente. Teste em uma rede aberta primeiro.
Versões do Node: o CLI acompanha os lançamentos recentes do LTS, então um gerenciador de versão (nvm ou similar) salva você de erros de incompatibilidade.
Seleção de organização de parceiro: se você pertencer a várias organizações, confirme se o CLI vinculou a correta antes de implantar.
Webhooks: eles são acionados contra sua URL de túnel no desenvolvimento, então um túnel morto significa eventos perdidos silenciosamente, não mensagens de erro.
Como aplicativos Shopify ganham dinheiro (e por que isso muda suas ferramentas)
Os aplicativos Shopify cobram dos lojistas através da API de Faturamento do Shopify: cobranças de plano recorrente, cobranças baseadas em uso ou compras únicas. Os lojistas pagam dentro do Shopify e sua receita chega via pagamentos de Parceiros. Esse fluxo é conveniente. Também é por isso que os desenvolvedores de aplicativos carecem de visibilidade de receita: o relatório de pagamento agrega tudo e a história no nível do plano (quem fez upgrade, quem cancelou, qual ponto de preço retém) nunca aparece. Projete seus planos sabendo que você vai querer essa história depois. É a diferença entre adivinhar e precificar com evidência.
Rastreando a receita de assinatura do seu aplicativo Shopify
A maioria dos tutoriais de desenvolvimento de aplicativos ignora essa parte. Depois que seu aplicativo cobra uma taxa recorrente dos lojistas, você tem um negócio de assinatura. E os relatórios de pagamento do Painel de Parceiros não vão dizer seu MRR, taxa de churn, LTV ou qual plano realmente retém lojistas.
Baremetrics tem um integração nativa com Shopify (uma das sete fontes de dados nativas) que transforma as cobranças de assinatura do seu aplicativo em um conjunto completo de métricas: cachoeira de MRR (novo, expansão, contração, churn), retenção de coorte, LTV, ARPU e segmentação por plano. Duas observações honestas de escopo. O MRR do Shopify está incluído, mas as próprias taxas do Shopify não são detalhadas da mesma forma que as taxas do Stripe. E o Baremetrics Recover (recuperação de pagamento falhado) funciona apenas com clientes do Stripe.
Usando o Mantle para análise de aplicativos Shopify? O Mantle anunciou sua descontinuação em junho de 2026 e interrompeu os relatórios em 14 de agosto de 2026. A integração nativa do Shopify do Baremetrics é o caminho de migração mais direto — veja por que os Shopify Partners escolhem o Baremetrics como uma alternativa ao Mantle — e suas configurações de dados por conexão permitem que você escolha como o tempo de receita, tempo de cancelamento e reembolsos são contabilizados.
E se seu negócio abrange Shopify mais Stripe (digamos, um aplicativo mais um SaaS autônomo), o Baremetrics normaliza ambos em uma visualização de MRR unificada — a visão de múltiplas fontes que nenhuma plataforma oferece por conta própria.
Criando na Shopify? Conecte sua loja ao Baremetrics gratuitamente e veja seu MRR real em minutos.
