The Broad Way é o kinho.dev: meu site pessoal e meu blog de engenharia, em português e inglês. O nome vem de uma frase de Miyamoto Musashi que o site imprime no console do navegador: "When you know the way broadly you see it in all things."
Escrevo sobre agentes de LLM, arquitetura e trabalho em produção, em três seções: logs, rants e nonsense. O site também reúne carreira e contato (/about), projetos, consultoria, as ferramentas que uso no dia a dia (/loadout) e meu currículo como ficha de personagem de D&D 5e (/sheet).
Comecei em 20 de novembro de 2025, a partir do create-next-app, e o site segue no ar em kinho.dev.
Vercel: Next.js 16 com App Router, React 19 e Tailwind v4. Middleware de idioma. Dois route groups com layouts raiz separados: (site), o site e o blog com a navegação de terminal, e (sheet), a ficha de personagem de D&D 5e em /sheet com HTML, estilos e quatro fontes próprios e um d20 desenhado em canvas que respeita reduced motion. Catálogo de posts sem banco: um módulo TypeScript por post e idioma, e uma função única que tira os rascunhos. Feeds: RSS em /en-US/rss.xml, /pt-BR/rss.xml e /rss.xml, mais /sitemap.xml, gerados a partir do mesmo catálogo. API de contato em POST /api/contact, com validação dos campos, honeypot e rate limit por IP.
GitHub: o repositório do site (pull request: preview; main: produção) e GitHub Issues num repositório privado como caixa de entrada do contato.
Resend: envio de e-mail do contato.
Visitante → Middleware: HTTPS. Requisição sem idioma é redirecionada para /pt-BR ou /en-US pelo Accept-Language, com en-US como padrão.
Middleware → Site e blog: rota para o route group (site).
Middleware → Ficha D&D: rota para o route group (sheet).
Site e blog → Catálogo de posts: módulos TypeScript dos posts lidos no build, sem os rascunhos.
RSS e sitemap → Catálogo de posts: leem os posts no build, pelo mesmo filtro de rascunhos.
Visitante → API de contato: POST JSON em /api/contact.
API de contato → GitHub Issues: REST API, cria uma issue; roda em paralelo com o envio de e-mail.
API de contato → Resend: REST API, envia o e-mail.
Repositório GitHub → Vercel: deploy. Cada pull request ganha um preview; o merge na main publica em produção.
A ficha de D&D vive num route group próprio, com HTML e body independentes.
Alternativa descartada: Estender a página com a moldura do site ou esconder essa moldura com CSS.
Por quê: Route groups separados dão HTML e body independentes e evitam renderizar uma navegação escondida e inacessível.
Rascunho é uma flag no post, e um único catálogo decide o que aparece.
Alternativa descartada: Filtrar rascunhos em cada lugar: home, listas, páginas de post, RSS e sitemap.
Por quê: Um filtro só cobre todos esses lugares, e os testes verificam que título, URL e texto de rascunho não aparecem no RSS nem no sitemap. A flag de prévia não é controle de acesso, e o README diz isso.
Slug explícito quando um título é corrigido.
Alternativa descartada: Sempre gerar o slug a partir do título.
Por quê: Corrigir um título mudaria a URL publicada. Com o slug fixado no slug original, os links que já circulam continuam funcionando.
Contato entregue por issue no GitHub como canal principal, com e-mail opcional. Conta como entregue se um canal aceitar.
Alternativa descartada: Depender só de um envio de e-mail.
Por quê: Cada mensagem vira uma issue e chega como notificação do GitHub. Se nenhum canal aceitar, a API devolve 502 e a página mostra o e-mail e o LinkedIn, então a mensagem não some em silêncio.