For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/web/blog-content.md (or send Accept: text/markdown).
Escrever artigos de blogue
Publica artigos locais e tipados com categorias e links de guias funcionais.
Instalação e configuração
Antes de qualquer etapa, leia Antes de começar e Noções básicas sobre terminal. Estas instruções presumem que você abriu o monorepo supastack completo no VS Code; sua raiz package.json marca a raiz do repositório. Nos comandos pnpm, um pacote de espaço de trabalho é um aplicativo ou uma pasta de código compartilhado; no produto, um espaço de trabalho é o contêiner de dados e o limite de segurança de uma equipe. corepack pnpm --filter ... seleciona um pacote do monorepo enquanto os comandos são executados a partir de sua raiz. Se você abriu apenas uma pasta móvel ou desktop sincronizada, ela não contém o back-end da Web, a configuração do Docker ou os scripts raiz: execute o back-end deste monorepo ou de um servidor hospedado acessível e use os próprios scripts da pasta da plataforma. Uma variável de ambiente é uma configuração nomeada armazenada em um arquivo .env local ou no painel de hospedagem; reinicie o aplicativo relevante após alterá-lo e mantenha os segredos do servidor fora dos valores NEXT_PUBLIC_ e EXPO_PUBLIC_.
1. No VS Code, abra apps/web/src/resources/content.ts e copie um artigo completo próximo como ponto de partida; a cópia do artigo fica no repositório, não em um painel de publicação.
2. Dê ao artigo um novo slug, título, categoria, data, seções e um slug de guia existente.
3. Na raiz do repositório, execute corepack pnpm --filter @supastack/web dev e abra http://localhost:3000/blog/<your-slug>. Esperado: o artigo e seu link de guia relacionado são carregados localmente antes de você compartilhar o URL.
O conteúdo do blog é armazenado em src/resources/content.ts e blog-posts.ts. Este é conteúdo gerenciado por repositório; não há serviço de publicação CMS. Cada postagem precisa de um slug, título, descrição, categoria, data, guia relacionado e seções exclusivos.
{
slug: 'your-article',
title: 'A specific reader question',
category: 'Guides',
date: '2026-09-07',
guide: 'web/local-setup',
sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}Comandos para copiar
Siga os comentários para ver em qual pasta um comando é executado. Se dois terminais estiverem rotulados, abra duas janelas de terminal e mantenha o primeiro comando em execução enquanto usa o segundo.
corepack pnpm --filter @supastack/web dev
# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.tsFluxo de implementação
Segue um objeto Post existente completo para os campos tipados restantes. Mantém o slug estável após publicação para que URLs partilhados continuem a funcionar. Os títulos precisam de IDs de secção únicos para o índice e links de âncora.
As categorias derivam do catálogo de artigos. O índice usa filtragem por URL e as rotas de artigo geram os seus metadados a partir do conteúdo. O valor guide deve corresponder a um slug de documentação existente; conteúdo relacionado deve levar a um próximo passo útil.
Verificação e resolução de problemas
Se o artigo retornar 404, verifique se seu slug é único e se foi adicionado à lista de artigos em apps/web/src/resources/content.ts.. Se o índice não levar a lugar nenhum, atribua a cada seção um ID exclusivo. Execute corepack pnpm test -- apps/web/src/resources/content.test.ts da raiz para ver erros de validação de conteúdo.
Corre os testes de conteúdo, abre a rota do artigo, segue o seu guia relacionado e verifica o índice filtrado. Verifica datas e afirmações contra as fontes. Não publiques links placeholder nem afirmes que uma integração foi verificada só porque aparece num artigo.