Craft CMS to Astro Migration
Your Craft Site Stalls While Buyers Wait For PHP To Render
Why leave Craft CMS?
- Renders Twig server-side on every request, adding 300-800ms PHP execution time before the first byte ships
- Forces frontend developers to toggle between JavaScript build tools and PHP/Twig templating syntax daily
- Requires LAMP/LEMP stack hosting or managed Craft services, multiplying infrastructure costs and attack surface
- Plateaus mobile Lighthouse scores at 45-65 without aggressive Redis caching or the paid Blitz plugin
- Locks your engineering team into Yii2 framework expertise, shrinking your hiring pool and slowing custom module work
- Couples content rendering to database query performance, creating unpredictable TTFB spikes under traffic
What you gain
- Delivers pre-rendered static HTML with 95-100 mobile Lighthouse scores out of the box, no caching plugins required
- Deploys to Vercel or Cloudflare edge networks where TTFB drops from seconds to sub-100ms globally
- Ships island architecture so interactive components load React, Vue, or Svelte only where needed, not across every page
- Hands frontend developers file-based routing and TypeScript components they can onboard to in hours, not weeks
- Fetches all content at build time via GraphQL, eliminating runtime database queries and the latency they create
- Preserves your entire URL structure, redirects, and SEO metadata through automated route mapping and 301 chains
Por que os times Craft CMS começam a olhar para Astro
Craft CMS conquistou sua reputação. O painel de controle é genuinamente agradável de usar. Os campos Matrix oferecem layouts flexíveis para equipes de conteúdo sem plugins. A API GraphQL funciona. O templating Twig é limpo. Para um CMS baseado em PHP construído no Yii2, Craft faz muito bem.
A história do frontend tem limites, porém. Os templates Twig renderizam no servidor a cada requisição, o que significa que seus scores de Lighthouse dependem do tempo de execução do PHP, camadas de cache do servidor e o quanto você força na otimização de assets. A maioria dos sites Craft que auditamos fica entre 45-65 no Lighthouse móvel. Não é terrível — apenas não competitivo quando frameworks estáticos existem.
O atrito real aparece em escala. A stack PHP/Yii2 do Craft força desenvolvedores frontend a fazer context-switch entre ferramentas JavaScript modernas e Twig. Seu pipeline de deployment passa por PHP. Hosting requer uma stack LAMP/LEMP ou um serviço gerenciado como Servd. Cada carregamento de página bate no banco de dados a menos que você esteja adicionando Redis, Blitz ou plugins de cache estático.
Astro elimina tudo isso no lado do frontend. Zero JavaScript por padrão. HTML estático na edge. E quando você precisa de interatividade, você traz exatamente o framework que quer — React, Vue, Svelte — com arquitetura de ilhas que hidrata apenas o que importa.
Dois caminhos de migração: escolha o que se encaixa
Oferecemos duas abordagens distintas dependendo de quanto você está investido na modelagem de conteúdo do Craft e na experiência do admin.
Opção A: Craft Headless + Frontend Astro
Se sua equipe de conteúdo ama o painel de controle do Craft — e muitos amam — mantenha-o. A API GraphQL do Craft expõe entries, assets, globals e campos customizados. Removemos completamente o frontend Twig e construímos seu site em Astro, puxando conteúdo via GraphQL no tempo de build.
Isso te dá:
- Saída HTML estática deployada para Vercel ou Cloudflare Pages
- Admin do Craft exatamente como seus editores o conhecem
- Builds incrementais disparadas por webhooks do Craft ao salvar conteúdo
- Entrega edge com TTFB sub-100ms globalmente
O tradeoff: você ainda mantém um servidor PHP para o backend do Craft. Custos de hosting ficam na faixa de $30-80/mês para hosting Craft gerenciado. Mas a performance do seu frontend se torna world-class.
Opção B: Migração completa para Payload CMS + Astro
Se você quer deixar o PHP completamente, migramos seu modelo de conteúdo para Payload CMS — um CMS nativo em TypeScript que roda em Node.js com MongoDB ou Postgres. A interface admin do Payload é baseada em React, altamente customizável e suporta o mesmo tipo de modelagem de conteúdo flexível que torna o Craft especial.
Isso te dá:
- Uma linguagem em toda a stack — TypeScript em tudo
- Self-hosted ou cloud com significativamente menor complexidade de infraestrutura
- Controle de acesso integrado que iguala ou excede as permissões de usuário do Craft
- APIs REST e GraphQL fora da caixa
- Nenhuma dependência de PHP em seu pipeline de deployment
Mapeamos suas seções Craft para coleções Payload, migramos blocos Matrix para campos de bloco do Payload e transferimos todo conteúdo programaticamente. Seus editores recebem um admin moderno que parece familiar em um dia.
Convertendo templates Twig para componentes Astro
Sites Craft usam Twig para templating. Astro usa componentes .astro com uma seção frontmatter de script e uma seção template HTML. O mapeamento é surpreendentemente limpo:
- Twig
{% include %}e{% embed %}se tornam importações de componentes Astro - Twig
{% for %}loops se tornam.map()em JavaScript no template - Twig
{% if %}condicionais se tornam expressões ternárias ou early returns - Queries
entry.matrixField.all()do Craft se tornam fragmentos GraphQL - Transformações de assets mapeiam para o componente
<Image />do Astro com otimização Sharp
Não apenas traduzimos sintaxe. Reestruturamos seus templates em uma arquitetura de componentes apropriada — layouts compartilhados, primitivos UI reutilizáveis e templates de página específicos de conteúdo. O resultado é uma base de código que qualquer desenvolvedor frontend moderno pode manter sem desempoeirar seu conhecimento de Twig.
Tratando blocos Matrix
Campos Matrix são o killer feature do Craft e precisam de migração cuidadosa. Cada tipo de bloco se torna um componente Astro (Opção A) ou um tipo de bloco Payload mais componente Astro (Opção B). Construímos um block renderer que mapeia dinamicamente blocos de conteúdo para componentes, preservando a flexibilidade editorial que sua equipe depende.
Estratégia de preservação de SEO
Sites Craft CMS tipicamente têm estruturas de URL limpas — sem extensões .php, sem parâmetros de query. Isso é boas notícias para migração. Nosso processo:
- Inventário completo de URL — Rastreamos seu site e catalogamos cada URL, redirect, tag canônica e link interno
- Mapeamento de rota 1:1 — O roteamento baseado em arquivo do Astro espelha sua estrutura de URL existente exatamente
- Mapa de redirects 301 — Qualquer URL que deva mudar recebe redirects permanentes configurados na edge
- Transferência de meta tag — Títulos SEO, descrições, tags OG e dados estruturados vão para o gerenciamento
<head>do Astro - Geração de XML sitemap — Construído automaticamente do seu conteúdo no tempo de build
- Monitoramento de Search Console — Rastreamos status de indexação por 90 dias pós-launch
Os dados do plugin SEOmatic do Craft são extraídos e mapeados para seus novos templates Astro. Nenhum ranking deixado para trás.
Nosso processo de migração
Semana 1-2: Auditoria e Arquitetura Documentamos sua instalação Craft — tipos de conteúdo, seções, blocos Matrix, volumes de assets, plugins, módulos customizados e quaisquer customizações Yii2. Recomendamos Opção A ou B baseado na direção técnica de sua equipe e requisitos de workflow de conteúdo.
Semana 3-5: Build Desenvolvimento do frontend Astro começa. Convertemos templates Twig para componentes Astro, integramos com a API GraphQL do Craft ou uma nova instância Payload CMS, e implementamos seu design system. Para Opção B, migração de conteúdo roda em paralelo.
Semana 6-7: Migração de conteúdo e QA Transferência completa de conteúdo (Opção B), testes de regressão visual contra seu site atual, benchmarking de performance e treinamento de equipe editorial em qualquer novo workflow.
Semana 8: Launch Cutover de DNS, verificação de redirect, submissão de Search Console e monitoramento de performance.
Saiba mais sobre nossas capacidades de desenvolvimento Astro.
Timeline e preço
Uma migração típica de Craft CMS para Astro leva 6-8 semanas.
- Opção A (Craft Headless + Astro): $15.000-30.000 dependendo da complexidade de template e número de tipos de bloco Matrix
- Opção B (Payload CMS + Astro): $25.000-50.000 incluindo migração completa de modelo de conteúdo e setup de CMS
Sites menores com menos de 20 templates e modelos de conteúdo diretos ficam na faixa mais baixa. Sites com configurações Matrix complexas, setups multi-site ou integração de Commerce requerem scoping customizado.
Por que Social Animal para esta migração
Migramos plataformas CMS baseadas em PHP para arquiteturas headless em dezenas de projetos. Conhecemos profundamente o modelo de conteúdo do Craft — incluindo casos extremos ao redor de eager loading, element queries e aninhamento de campos Matrix. E construímos sites Astro que pontuam 95+ no Lighthouse sem sacrificar flexibilidade editorial.
Sua equipe de conteúdo não deveria ter que fazer compromissos. A performance do seu frontend também não.
The migration process
Discovery & Audit
We map every page, post, media file, redirect, and plugin. Nothing gets missed.
Architecture Plan
New stack designed for your content structure, SEO requirements, and performance targets.
Staged Migration
Content migrated in batches. Each batch verified before the next begins.
SEO Preservation
301 redirects, canonical tags, sitemap, robots.txt — every ranking signal carried over.
Launch & Monitor
DNS cutover with zero downtime. 30-day monitoring period included.
Craft CMS vs Astro
| Metric | Craft CMS | Astro |
|---|---|---|
| Lighthouse Mobile | 45-65 | 95-100 |
| TTFB | 800ms-2.5s | <100ms |
| Build Time (100 pages) | N/A (server-rendered) | ~15s |
| Hosting Cost | $30-80/mo (managed) | $0-20/mo (edge CDN) |
| Developer Experience | PHP/Twig/Yii2 | TypeScript/Astro/Modern JS |
| API/Headless | GraphQL (built-in) | Full headless (GraphQL or REST) |
Common questions
Posso manter Craft CMS e apenas substituir o frontend Twig por Astro?
Sim. Craft CMS tem uma API GraphQL integrada que expõe todo seu conteúdo — entries, assets, globals e blocos Matrix. Removemos completamente a camada de template Twig e construímos um frontend Astro que busca conteúdo via GraphQL no tempo de build. Seus editores continuam usando o painel de controle do Craft sem mudanças em seu workflow.
Como o Payload CMS se compara ao Craft CMS para edição de conteúdo?
O painel admin do Payload é baseado em React com campos de bloco que espelham a funcionalidade Matrix do Craft. A experiência de edição é moderna e responsiva. O sistema de controle de acesso do Payload é definido por código, o que o torna mais flexível que as permissões integradas do Craft. O principal ajuste para editores é aprender uma nova interface — isso tipicamente leva um ou dois dias de uso prático.
Minhas URLs do Craft CMS vão mudar durante a migração para Astro?
Não. Mapeamos sua estrutura de URL existente 1:1 no roteamento baseado em arquivo do Astro. Sites Craft tipicamente usam URLs limpas sem extensões, que Astro trata nativamente. Qualquer URL que deva mudar por razões estruturais recebe redirects permanentes 301. Verificamos cada URL pós-launch para garantir zero links quebrados.
Como blocos Craft CMS Matrix traduzem para componentes Astro?
Cada tipo de bloco Matrix se torna um componente Astro individual. Construímos um block renderer que recebe dados de bloco do GraphQL e mapeia dinamicamente cada tipo de bloco para seu componente correspondente. Isso preserva flexibilidade editorial completa — sua equipe de conteúdo pode continuar misturando e combinando blocos exatamente como antes.
O que acontece com plugins Craft CMS como SEOmatic durante a migração?
Extraímos todos os dados SEOmatic — títulos meta, descrições, tags OG, dados estruturados e configuração de sitemap — e migramos para seu build Astro. Para Opção A, dados SEOmatic são consultados via GraphQL. Para Opção B com Payload, configuramos campos SEO equivalentes em cada coleção e transferimos os dados programaticamente.
Quão mais rápido meu site será após migrar do Craft CMS para Astro?
A maioria dos sites Craft CMS pontua 45-65 no Lighthouse móvel por causa de renderização PHP e consultas ao banco de dados em cada requisição. Após migração para Astro com saída estática em um CDN edge, sites consistentemente pontuam 95-100 com TTFB abaixo de 100ms. Isso se traduz em Core Web Vitals mensuravelmente melhores e sinais de ranking de busca aprimorados.
Ready to migrate?
Free assessment. We'll audit your current site and give you a clear migration plan — no commitment.
Let's build
something together.
Whether it's a migration, a new build, or an SEO challenge — the Social Animal team would love to hear from you.