TYPO3 é de nível enterprise, testado em batalha e construído para uma era diferente da web.

A história headless é um complemento

O TYPO3 foi concebido como um CMS tradicional do lado do servidor. O seu output nativo é HTML renderizado por templates Fluid. A extensão EXT:headless — mantida pela comunidade TYPO3 Headless, e não pela TYPO3 GmbH — transforma isto numa API JSON.

Funciona, e para equipas que investiram no TYPO3 e precisam de expor conteúdo como API, é um caminho razoável. Mas é uma extensão da comunidade, com o seu próprio ciclo de releases, a sua própria superfície de compatibilidade com as versões core do TYPO3 e a sua própria documentação. Não há SLA, nem contrato de API versionada por parte da TYPO3 GmbH, nem SDK TypeScript.

O b10cks foi desenhado como CMS headless desde o primeiro dia. A API é o produto. Cada decisão de design — arquitetura de blocos, localização, versionamento, webhooks — foi tomada para servir consumidores da API, não renderizadores de templates.

A interface editorial

A interface de backend do TYPO3 (o "Backend") é poderosa e altamente configurável, mas tem uma curva de aprendizagem que a maioria das equipas reconhece com honestidade. O paradigma de elementos de conteúdo (tt_content, configuração TypoScript, FlexForms para conteúdo estruturado) não é intuitivo para editores não técnicos. O onboarding costuma exigir formação estruturada.

O TYPO3 v12 e o v13 trouxeram melhorias no backend e uma UI renovada — o progresso é real. Mas o modelo mental fundamental — árvore de páginas, colunas de conteúdo, TypoScript — continua diferente da forma como as equipas de conteúdo modernas trabalham.

O editor visual do b10cks vive dentro do site real da equipa. Os editores clicam nos elementos que querem alterar e editam-nos no local. O onboarding é mínimo porque a interface é o produto que os editores usam todos os dias.

Localização: o verdadeiro ponto forte do TYPO3

É aqui que o TYPO3 realmente lidera. O seu sistema de localização — tradução ao nível do campo, cadeias de fallback por localidade, árvores de páginas por idioma, acompanhamento do estado das traduções — está entre os mais maduros em qualquer CMS. Organizações que gerem 20+ idiomas em estruturas de site complexas contam com ele há décadas.

A localização do b10cks é robusta para a maioria dos requisitos do mundo real: tradução ao nível do campo, herança de localidade, fluxos de publicação por localidade, integração com ferramentas profissionais de tradução (Lokalise, Phrase, DeepL). Para equipas que começam de novo, cobre todas as funcionalidades sem complexidade legada.

Para organizações que já operam fluxos de trabalho de tradução TYPO3 profundamente complexos, a diferença de maturidade merece ser avaliada com honestidade.

Workspaces: o outro ponto forte do TYPO3

O módulo Workspaces do TYPO3 é um dos sistemas de staging de conteúdo mais poderosos do mercado CMS. Os editores podem preparar versões inteiras de um site num workspace isolado, comparar com o conteúdo em produção, fazer pré-visualização e lançar tudo em lote — em várias páginas, elementos de conteúdo e localidades ao mesmo tempo.

O b10cks oferece histórico de versões ao estilo do git, branching e releases atómicas: podes agrupar várias alterações de conteúdo numa única implementação agendada. Para a maioria das equipas de conteúdo de produto, isto é mais do que suficiente.

Para grandes operações editoriais que gerem lançamentos completos do site como eventos atómicos — pensa em portais governamentais, grandes sites de media em época de eleições — o sistema Workspaces do TYPO3 é uma ferramenta especializada que o b10cks não iguala em profundidade.

A experiência de desenvolvimento

Configurar um stack headless moderno em TYPO3 requer um investimento real: o core do TYPO3, configuração da EXT:headless, TypoScript para mapeamento de campos da API, integração com uma framework de frontend (Nuxt-TYPO3 é a opção principal) e configuração do FAL (File Abstraction Layer), caching e CDN.

Implementação self-hosted do b10cks:

git clone https://github.com/b10cks/cms
cd cms && docker compose up

E já tens um CMS a correr. Acrescenta um domínio. Liga o frontend via SDK TypeScript.

A API está documentada com uma especificação OpenAPI. Existem adaptadores de framework para Next.js, Nuxt, Astro e Vue. O modelo de conteúdo é definido no canvas infinito e refletido imediatamente na API.

Modelação de conteúdo: árvores de páginas vs. blocos

O TYPO3 organiza o conteúdo numa árvore de páginas: as páginas são a entidade principal e os elementos de conteúdo vivem dentro de regiões de colunas da página. Este modelo encaixa bem em websites tradicionais, mas exige decisões arquitetónicas adicionais para cenários de content-as-a-service (conteúdo partilhado entre várias páginas ou canais).

O b10cks organiza o conteúdo como blocos: cada tipo de conteúdo é um bloco componível e reutilizável. Os blocos podem ser referenciados entre páginas e canais sem duplicação. O modelo de conteúdo é definido visualmente e reflete um pensamento API-first: o conteúdo não está preso a uma localização de página, é um recurso.