Pular para conteúdo
Logo
Overview
auth-md — site comunitário sobre autenticação declarativa

auth-md — site comunitário sobre autenticação declarativa

May 24, 2026
1 min read

O projeto

A WorkOS lançou o protocolo auth.md — autenticação declarativa via arquivo Markdown — e encontrei o domínio auth-md.com livre. Registrei no mesmo dia.

A aposta: se o protocolo pegar tração (e tem cara de que vai), quem tiver conteúdo informacional de qualidade ranqueia primeiro.

O que faz

O site explica o que é auth.md, documenta a especificação, ensina a instalar e oferece um validador. Tudo em inglês, porque o protocolo é global.

Páginas:

  • Homepage com early adopters (Resend, Cloudflare, Anthropic)
  • What is auth.md — porta de entrada para SEO
  • Specification — referência técnica completa
  • Install — skill para agentes de IA
  • Validator — verifica se o arquivo está correto

O footer deixa claro: recurso independente, não oficial da WorkOS.

Stack

Astro 6 estático, UnoCSS, deploy via Coolify no meu homelab. DNS no Cloudflare, analytics com GA4 e Plausible self-hosted.

O design segue estética blueprint reversa — fundo claro, linhas azuis, accent laranja. Diagramas SVG no estilo CAD, disponíveis no DESIGNMD.APP.

O processo

Comecei pelo CONTEXT.md com todas as decisões de design, escopo e stack. Usei agentes para stress-testar o plano contra a documentação e fechar as pontas.

Deploy é push para GitLab, webhook dispara build no Coolify, nginx serve o estático.

O foco de SEO/GEO foi na query “what is auth.md” como porta de entrada. O CTA principal é “instale a skill”, não “leia a spec”, porque quem instala volta ao site como referência.

Resultado

Site no ar em menos de 48h. Indexado no Google no mesmo dia.


Para o registro completo de como construí o projeto, veja o insight detalhado.

auth-md.com

Leitura Relacionada