Ter um ambiente local confiável é fundamental para qualquer desenvolvedor WordPress, seja para criar temas, plugins ou sites completos. Embora existam várias ferramentas para isso, o Studio do WordPress.com rapidamente se tornou a minha favorita — especialmente popular entre quem trabalha com sites hospedados na própria plataforma.
Neste post, vou apresentar os principais recursos do Studio, mostrar alguns fluxos de trabalho que costumo usar no desenvolvimento de projetos WordPress e dar uma prévia do que vem por aí em 2025. Se você está começando a usar o Studio ou quer otimizar sua rotina, vale a pena conferir.
O que é o Studio?
O Studio é uma ferramenta gratuita pensada para facilitar o desenvolvimento local com WordPress — independentemente do tipo de projeto que você está construindo. Ele se integra diretamente com sites hospedados no WordPress.com, mas também pode ser usado com qualquer outro provedor de hospedagem. Além disso, está disponível em vários idiomas, incluindo o português do Brasil.
Como projeto de código aberto mantido no GitHub, o Studio está em constante evolução com contribuições da comunidade WordPress.
Arquitetura do Studio: uma visão técnica
Lançado em abril de 2024, o Studio é uma adição recente ao ecossistema de ferramentas para desenvolvimento local. Diferente de soluções mais tradicionais, ele roda sobre o WordPress Playground e utiliza SQLite como banco de dados padrão — em vez de MySQL — o que o torna mais leve e fácil de usar.
Enquanto ferramentas como o wp-env oferecem flexibilidade via linha de comando, o Studio proporciona uma experiência mais acessível por meio de uma interface gráfica (GUI), de forma semelhante ao que o GitHub Desktop faz para fluxos de trabalho com Git. Além disso, o Studio não depende de ferramentas externas como Docker, exigência comum em outras soluções.
Por trás da interface, o Studio é um aplicativo construído com Electron, usando componentes do WordPress e Tailwind CSS para oferecer uma experiência moderna e intuitiva. Para saber mais sobre a parte técnica, confira os artigos (em inglês) da equipe de desenvolvimento:
O Studio está disponível para macOS e Windows. O suporte para Linux ainda está em aberto e pode ser acompanhado via GitHub. Você não precisa de uma conta no WordPress.com para usar o Studio, mas fazer login desbloqueia funcionalidades adicionais como o assistente com IA, os Sites de prévia e o Studio Sync (estes dois últimos serão detalhados mais adiante).
Como funciona o fluxo de trabalho
Se você já trabalhou com outras ferramentas com interface gráfica (GUI) para desenvolvimento local, o Studio vai parecer familiar. É possível criar e gerenciar múltiplos sites WordPress dentro do próprio aplicativo. Cada novo site é salvo por padrão em uma pasta ~/Studio no diretório do usuário, mas é possível definir um caminho personalizado para se adequar ao seu projeto.
Minha recomendação é criar um novo site no Studio sempre que for iniciar um projeto WordPress. Ter ambientes locais separados facilita bastante o teste de temas, plugins e configurações específicas.
Para configurar um site no Studio:
- Abra o Studio e clique em Adicionar site.
- Dê um nome para o seu projeto.
- (Opcional) Ative as Configurações avançadas para definir um caminho personalizado, escolher a versão do WordPress e do PHP, ou definir um domínio local.
- Clique em Adicionar site para finalizar.
Dica: Consulte a documentação oficial do Studio (em inglês) para mais detalhes sobre os recursos disponíveis.
O fluxo de trabalho ideal para desenvolvimento local
O fluxo de trabalho ideal depende do tipo de projeto que você está desenvolvendo e da sua forma de trabalhar.
A criação de plugins e temas normalmente exige uma abordagem diferente da construção de um site completo — especialmente quando você aproveita os recursos nativos do Studio, como os Sites de prévia e o Studio Sync, ou ferramentas adicionais disponíveis para desenvolvedores no WordPress.com.
A seguir, apresento duas abordagens comuns:
- Desenvolvimento de plugins e temas: Melhores práticas para construir e testar no Studio, usando Git para controle de versão e fazendo a implantação para um site no WordPress.com com o recurso de Implantações do GitHub.
- Desenvolvimento de sites completos: Como estruturar a criação de um site do zero, compartilhar prévias com clientes ou colegas e sincronizar com um site ativo no WordPress.com.
Esses fluxos de trabalho não são uma receita única — adapte-os conforme suas necessidades.
Desenvolvimento de plugins e temas
Um dos motivos mais comuns para configurar um ambiente local é desenvolver plugins ou temas para WordPress. Para começar, você precisa acessar a pasta themes ou plugins do seu site local.
Abra o Studio (caso ainda não tenha feito isso) e vá até a aba Visão Geral do seu site. Em Abrir em…, selecione Finder (macOS) ou Explorador de Arquivos (Windows). Isso abrirá a pasta do site no seu computador.
Navegue até a pasta wp-content, onde você encontrará os diretórios themes e plugins.
Crie uma nova pasta dentro do local apropriado e abra-a no seu editor de código preferido. O Visual Studio Code (VS Code) é uma escolha popular, mas editores como Cursor e Windsurf também são ótimas opções — especialmente se você busca recursos com IA.
Alguns desenvolvedores preferem abrir toda a pasta do site no editor, enquanto outros trabalham apenas dentro do diretório do projeto. Ambas as abordagens funcionam — escolha a que melhor se adapta ao seu fluxo de trabalho.
A estrutura de arquivos de um plugin, por exemplo, ficaria assim dentro do diretório do site no Studio:
A partir daqui, você já pode começar a codificar. Embora este artigo não cubra todos os detalhes do desenvolvimento de plugins ou temas, aqui estão alguns recursos úteis (em inglês):
Assim que seu projeto estiver configurado, o plugin ou tema aparecerá automaticamente na área Aparência ou Plugins do painel administrativo do seu site no Studio. Ative, teste e itere conforme necessário.
Implantação de plugins e temas
Com seu plugin ou tema pronto, o próximo passo é implantá-lo em um site ativo.
Existem várias formas de fazer isso, dependendo do objetivo do projeto. Para lançamentos públicos, uma opção é hospedar o código no WordPress.org. Mas se o plugin ou tema for feito sob medida — como projetos para clientes ou uso interno — é comum armazená-lo e mantê-lo em plataformas como GitHub ou Bitbucket.
O controle de versão com Git é parte fundamental de qualquer fluxo moderno de desenvolvimento. Ele permite rastrear alterações, colaborar com outras pessoas e reverter mudanças quando necessário. Mesmo em projetos individuais, manter um repositório Git ajuda a garantir organização e escalabilidade.
Além disso, usar Git facilita a implantação. Muitos serviços de hospedagem para WordPress oferecem suporte a deploys via Git, eliminando a necessidade de enviar arquivos manualmente por FTP ou SSH.
No WordPress.com, isso é feito através do recurso Implantações do GitHub, compatível com qualquer repositório público ou privado hospedado no GitHub.com. É uma das ferramentas que mais gosto de usar no dia a dia. Para começar, transforme seu projeto em um repositório Git.
O Git já vem instalado no macOS e pode ser facilmente instalado no Windows. Para verificar se está instalado, abra o terminal (linha de comando) e execute:
Se o Git estiver instalado, você verá o número da versão. Caso contrário, aparecerá uma mensagem de erro como command not found.
Com o Git instalado, abra o terminal, navegue até a pasta do seu projeto e inicialize o repositório com:
Você pode usar a linha de comando para continuar, mas se preferir uma interface gráfica, o GitHub Desktop oferece uma experiência mais amigável — assim como o Studio faz para o WordPress.
Para criar o repositório no GitHub:
- Abra o GitHub Desktop.
- Vá em Arquivo > Adicionar Repositório Local…
- Selecione a pasta do seu projeto.
- Confirme e publique no GitHub.
Depois que seu projeto estiver no GitHub, conecte-o ao WordPress.com via Implantações do GitHub. Esse recurso está disponível nos planos Negócios e Commerce.
Com implantações automáticas ativadas, qualquer commit no branch principal (geralmente main) será publicado automaticamente nos sites conectados, incluindo ambientes de teste. Também é possível ativar deploys manuais, se preferir.
Importante: independentemente da opção escolhida, a primeira implantação precisa ser acionada manualmente.
Embora este fluxo se concentre em plugins e temas, também é possível usar o mesmo recurso para enviar toda a pasta wp-content — útil para quem quer versionar temas, plugins e outros arquivos em um único repositório, mantendo consistência entre diferentes ambientes.
Dica: Consulte a documentação das Implantações do GitHub para mais detalhes sobre como configurar esse recurso.
À medida que o Studio continua evoluindo, novas funcionalidades estão sendo adicionadas para facilitar ainda mais a construção e implantação de projetos WordPress. A seguir, vamos ver como estruturar o desenvolvimento de um site completo.
Desenvolvimento de site completo
O Studio não serve apenas para criar plugins e temas — ele também é excelente para desenvolver sites WordPress completos. Embora alguns projetos exijam código personalizado, muitos sites são construídos simplesmente escolhendo um tema, instalando plugins, adicionando conteúdo e personalizando o design no Editor. Tudo isso pode ser feito facilmente dentro do Studio.
Para começar, basta seguir os passos anteriores para criar um novo site no Studio. Depois disso, você pode usar a interface do WordPress normalmente, como faria em qualquer site ativo.
Se estiver trabalhando com um tema de blocos, recomendo instalar o plugin Create Block Theme. Ele facilita a personalização e permite que você:
- Salve alterações em templates e Estilos Globais diretamente no tema ativo.
- Exporte essas alterações como um novo tema, sem precisar escrever uma linha de código.
Este tutorial (em inglês) oferece um passo a passo completo sobre como usá-lo.
O Studio também permite sincronizar um site WordPress.com (nos planos Negócios ou Commerce) com o ambiente local. Esse recurso é muito útil se você já começou a construir o site online ou deseja usar um tema premium do WordPress.com — que não pode ser baixado ou instalado fora dessa plataforma.
Para sincronizar um site:
- Crie um site nos planos Negócios ou Commerce no WordPress.com (caso ainda não tenha).
- (Opcional) Aplique o tema premium que deseja usar.
- No Studio, clique em Adicionar site e siga o processo de criação.
- Vá até a aba Sync do site recém-criado.
- Faça login na sua conta do WordPress.com, se necessário.
- Clique em Conectar site e selecione o site que deseja sincronizar.
- Confirme a conexão e clique em Puxar para importar a versão ativa ou de testes.
Depois da sincronização, você pode continuar o desenvolvimento localmente no Studio. Consulte a documentação do Sync para mais detalhes. Exploraremos esse recurso novamente na próxima seção.
Desenvolver sites localmente oferece os mesmos benefícios que desenvolver plugins e temas: você pode testar mudanças com segurança antes de publicá-las. Embora o WordPress.com também ofereça ambientes de teste, o Studio proporciona mais flexibilidade, permitindo trabalhar offline e com mais foco — sem depender da conexão com servidores remotos.
Um guia completo sobre como criar um site WordPress está além do escopo deste post, mas aqui vão alguns recursos úteis para quem está começando:
- Desenhe seu site: Veja como projetar seu blog ou site com diferentes temas e opções de personalização.
- Learn WordPress: Cursos gratuitos sobre design de sites com WordPress.
- Guia Rápido: Comece a construir com a documentação oficial de temas.
Visualizando e implantando um site completo
Quando seu site estiver pronto — ou quase — é hora de testar e fazer a implantação. O Studio oferece duas funcionalidades principais que tornam esse processo muito mais simples: Sites de prévia e Sync do Studio.
Os Sites de prévia permitem gerar uma versão temporária hospedada do seu site local criado no Studio, ideal para testar funcionalidades em um ambiente real. Em vez de configurar manualmente um ambiente de testes, você pode criar essa visualização com um clique e compartilhá-la com clientes, colegas ou outras partes interessadas para obter feedback. É especialmente útil para projetos completos em que conteúdo, design e funcionalidades precisam ser avaliados em conjunto antes da publicação.
Essa funcionalidade está disponível para todos os usuários do Studio, mas exige login com uma conta gratuita ou paga do WordPress.com.
Para criar uma prévia:
- Acesse a aba Visualizações do seu site no Studio.
- Clique em Fazer login no WordPress.com, caso ainda não tenha feito login.
- Clique no botão Criar site de prévia.
- Quando a visualização estiver pronta, acesse a URL gerada para ver a prévia ao vivo.
Cada site de prévia permanece disponível por sete dias após a última atualização. É possível manter até 10 prévias simultâneas, o que facilita testar diferentes versões de um projeto ou trabalhar em vários ao mesmo tempo.
Para mais detalhes, consulte a documentação dos Sites de prévia.
Se o seu site estiver hospedado no WordPress.com (nos planos Negócios ou Commerce), o Sync do Studio permite conectar seu ambiente local diretamente a um site online — sem precisar migrar arquivos ou bancos de dados manualmente.
Você pode enviar atualizações do ambiente local para o site ativo com um clique, ou até mesmo usar o recurso para implantar um site completo do zero diretamente do Studio.
Para sincronizar com o WordPress.com:
- Acesse a aba Sync do seu site no Studio.
- Clique em Fazer login no WordPress.com, caso ainda não esteja logado.
- Clique em Conectar site para visualizar os sites disponíveis.
- Selecione o site desejado e clique em Conectar.
- Clique em Push para sincronizar seu site local com o site conectado no WordPress.com.
A interface mostra claramente quais sites estão conectados — seja de produção ou de teste — e o status de sincronização.
O Sync é bidirecional, ou seja, você também pode puxar atualizações de um site do WordPress.com para o Studio. Isso é especialmente útil em equipes de desenvolvimento ou quando é necessário revisar e ajustar um site já publicado. Também é possível sincronizar com ambientes de teste para validar mudanças antes da publicação.
A documentação do Sync do Studio fornece instruções detalhadas sobre como configurar e usar o recurso.
Ao usar o Sync, todo o site é transferido — incluindo arquivos e banco de dados. Atualmente, o recurso é mais adequado para sincronizações completas de sites, e não permite ainda implantar apenas um plugin ou tema individual. No entanto, essa limitação já está sendo discutida pela equipe, e melhorias nesse sentido devem chegar em versões futuras do Studio.
O que vem a seguir para o Studio?
Este artigo apresentou uma visão geral dos recursos atuais do Studio e de alguns fluxos de trabalho comuns para desenvolvedores WordPress.
Embora o Studio já seja uma ferramenta poderosa para desenvolvimento local, a equipe continua trabalhando em melhorias — com atualizações promissoras previstas para breve.
Duas novidades que estou particularmente ansioso para ver:
- Suporte a SSL: permitirá que os sites locais funcionem com HTTPS, simulando melhor ambientes de produção.
- Suporte expandido ao PHP: incluindo compatibilidade com Xdebug, symlinks e outras melhorias que vão agradar quem precisa de mais controle no desenvolvimento.
Por ser baseado no WordPress Playground, que usa uma versão do PHP compilada com WebAssembly, o Studio ainda apresenta algumas limitações quando comparado a outras ferramentas. Mas a equipe já está se movendo para superar essas barreiras e oferecer mais flexibilidade para quem desenvolve com WordPress.
Se você tiver sugestões de melhorias, esse é um excelente momento para contribuir. É possível abrir issues ou enviar sugestões diretamente no repositório do Studio no GitHub, ou deixar seu comentário por aqui. Seu feedback ajuda a direcionar o futuro da ferramenta.
Ainda não experimentou o Studio? Baixe agora gratuitamente e veja como ele pode acelerar seu fluxo de trabalho com WordPress. Com lançamentos frequentes de funcionalidades e uma comunidade ativa de código aberto, o aplicativo está melhorando rapidamente.
Após a instalação, não se esqueça de conectar o Studio à sua conta do WordPress.com (gratuita ou paga) para desbloquear funcionalidades como Sync e Sites de prévia.
