# Boas práticas com Supabase via CLI > Por que usar o Supabase via linha de comando é a melhor escolha para times de desenvolvimento? Veja dicas práticas e comandos que facilitam. URL: https://bixtecnologia.com.br/supabase-boas-praticas/ Idioma: pt-BR Publicado em: 2025-05-06T17:51:04.000Z ## Supabase via CLI: boas práticas para desenvolver com mais controle e segurança 6 de maio de 2025 6 min de leitura O Supabase vem ganhando espaço como uma das soluções mais práticas para quem precisa de um backend completo e fácil de usar. Com uma proposta parecida com o Firebase, mas baseada em tecnologias abertas como PostgreSQL, ele oferece banco de dados, autenticação, armazenamento e funções serverless num pacote bem integrado. Apesar da interface web ser intuitiva, a melhor forma de usar o Supabase em projetos reais é via linha de comando, com a [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started). Isso porque ela permite que tudo fique versionado, testável localmente e replicável entre ambientes. Ou seja, menos chances de erro e mais controle sobre a evolução do projeto. Neste artigo, explicamos por que você deve priorizar o uso da CLI, como começar e quais boas práticas adotar para manter seu [projeto tecnológico](https://bixtecnologia.com.br/projeto-de-tecnologia/) organizado, seguro e fácil de manter – tanto em time quanto individualmente. Continue a leitura! ## Por que usar a Supabase CLI? Fazer alterações diretamente na interface web pode parecer mais rápido em um primeiro momento, mas torna difícil rastrear mudanças, compartilhar configurações ou garantir que o ambiente de produção esteja alinhado com o de desenvolvimento. A Supabase CLI resolve esses problemas ao permitir que você: - crie e aplique migrações de [banco de dados](https://bixtecnologia.com.br/banco-de-dados/) via código; - teste alterações localmente antes de levá-las para produção; - mantenha arquivos de configuração e scripts versionados no repositório; - sincronize o estado do banco com facilidade entre ambientes diferentes. Essa abordagem facilita a manutenção do projeto no longo prazo, reduz riscos e melhora a colaboração entre desenvolvedores. ## Começando com a Supabase CLI Antes de tudo, é importante garantir que você tenha o [Node.js](https://nodejs.org/) e o npm instalados na sua máquina – eles são necessários para rodar a Supabase CLI via _npx_. Uma vez que tudo esteja devidamente instalado, o primeiro passo para usar a Supabase via linha de comando é instalar a CLI. Ela pode ser usada com _npx_, sem necessidade de instalação global: ``` npx supabase --help ``` Esse comando cria os arquivos iniciais do projeto, como o _supabase/config.toml_, que é essencial para manter a configuração do ambiente. Você também pode instalar globalmente com npm (opcional): ``` npm install -g supabase ``` Para inicializar um novo projeto: ``` npx supabase init ``` A partir daí, você pode subir o ambiente local com: ``` npx supabase start ``` Isso roda containers com banco de dados PostgreSQL, Studio, autenticação e outros serviços da stack Supabase. Já para interromper, use: ``` npx supabase stop ``` ## Migrações versionadas e testes locais Ao trabalhar com banco de dados, é fundamental que alterações estruturais – como criação de tabelas ou mudança de tipos de colunas – sejam registradas de forma clara e reaplicável. A CLI do Supabase facilita isso com migrações SQL que ficam salvas no repositório. Para criar uma nova migração, basta rodar: ``` npx supabase migration new nome_da_migracao ``` Você também pode aplicar alterações no banco local a partir das novas migrações, com o comando: ``` npx supabase db push --local ``` Também é possível aplicar alterações locais no banco de dados em produção com o comando _npx supabase db_ _push_, ou resetar o estado do banco com _npx supabase db reset_. Isso é útil para testar tudo do zero antes de levar para produção. Outro ponto importante: sempre sincronize seu banco local com o schema atual usando _npx supabase db pull_ e mantenha o histórico de alterações organizado no versionamento. Com isso, é possível reverter erros e acompanhar a evolução do projeto com mais confiança. ## Subindo alterações para produção com segurança Depois de testar localmente, é hora de sincronizar seu projeto com o Supabase Cloud. Você pode linkar o projeto com: ``` npx supabase link --project-ref ``` A partir disso, é possível aplicar as alterações diretamente no ambiente remoto com o comando: ``` npx supabase db push --linked ``` Vale lembrar que, mesmo com essa facilidade, o ideal é sempre revisar bem as alterações antes de aplicá-las na produção. E, claro, manter backups atualizados. ## Outras funcionalidades da CLI Além de lidar com migrações e o ambiente local, a Supabase CLI também oferece comandos úteis para manutenção e backup do banco. Um deles é o _npx supabase db dump_, usado para gerar um backup (dump) do banco de dados PostgreSQL de um projeto Supabase. Ele cria um arquivo _.sql_ contendo toda a estrutura (schema) e, opcionalmente, os dados do banco atual – funcionando de forma semelhante ao que o _pg_dump_ do PostgreSQL faz. Essa é uma forma prática de versionar o estado do banco ou mover dados entre ambientes com mais controle e segurança. Ao final, o Supabase local estará disponível em [http://localhost:54323](http://localhost:54323/). É por essa porta que você acessa o banco de dados local para testes e desenvolvimento. ## Boas práticas para usar o Supabase via CLI Pra fechar, algumas recomendações que ajudam a manter seu projeto saudável: - Priorize sempre a CLI no lugar da interface web; - Versione todas as migrações e inclua o _supabase/config.toml_ no repositório; - Use arquivos .env para guardar chaves como _SUPABASE_ANON_KEY_ e _SERVICE_ROLE_KEY_; - Não versione o arquivo _.env_ no git e coloque-o no _.gitignore_; - Teste migrações localmente antes de aplicar em produção; - Reinicie os containers (_stop_ e _start_) sempre que fizer alterações relevantes na configuração. ## Aprendizado contínuo é parte do código Usar a Supabase CLI pode parecer um passo a mais no início, mas é um investimento que vale a pena. Ela ajuda a manter seu projeto organizado, seguro e fácil de escalar; tudo isso com uma experiência de desenvolvimento fluida e moderna. Para continuar acompanhando conteúdos sobre ferramentas, práticas e processos que fortalecem o Desenvolvimento de Software, [acesse o blog da BIX](http://bixtecnologia.com.br/blog) e fique por dentro das novidades! ## Artigos relacionados Inteligência Artificial Dicas ### [Maturidade, barreiras e ROI dos Agentes de IA no mercado: hype, piloto ou operação? ·](https://bixtecnologia.com.br/maturidade-barreiras-e-roi-dos-agentes-de-ia-no-mercado-hype-piloto-ou-operacao/) Acesse a pesquisa da BIX Tecnologia sobre agentes de IA. 24 de junho de 2026 7 min de leitura Inteligência Artificial Dicas ### [Claude: os modelos de linguagem de grande escala da Anthropic](https://bixtecnologia.com.br/claude-modelos-de-linguagem-anthropic/) Conheça o Claude, os LLMs da Anthropic, e seus recursos 22 de junho de 2026 5 min de leitura Inteligência Artificial Dicas ### [O princípio de Agent Skills do Claude: o segredo para agentes de IA precisos](https://bixtecnologia.com.br/agent-skills-do-claude-agentes-de-ia/) Como o Agent Skills do Claude cria agentes de IA precisos 22 de junho de 2026 5 min de leitura Engenharia de Dados Dicas ### [O erro mais comum em projetos de engenharia de dados que trava o crescimento](https://bixtecnologia.com.br/erro-comum-projetos-de-engenharia-de-dados/) Por que projetos de engenharia de dados falham e como evitar 18 de junho de 2026 7 min de leitura Inteligência Artificial Dicas ### [Como as empresas estão usando agentes de IA para automatizar operações em 2026](https://bixtecnologia.com.br/agentes-de-ia-automatizar-operacoes-2026/) Como agentes de IA automatizam operações nas empresas em 2026 18 de junho de 2026 5 min de leitura ![Infográfico mostrando a conexão entre endpoints, documentação e segurança em um design de APIs eficiente.](https://bixtecnologia.com.br/img/O_design_de_AP_Is_como_motor_de_crescimento_e_vantagem_competitiva_8b5e20a6ec-960.webp) Dicas ### [O design de APIs como motor de crescimento e vantagem competitiva](https://bixtecnologia.com.br/design-de-apis-vantagem-competitiva/) 9 de março de 2026 5 min de leitura --- BIX Tecnologia · Contato: https://bixtecnologia.com.br/contato/ Índice do site para agentes: https://bixtecnologia.com.br/llms.txt