Deployment Runbook: Heroku + Cloudflare This runbook describes the production path for a Next.js application hosted on Heroku and exposed through a Cloudflare-managed custom dom…
Authentication Runbook: GitLab OAuth + Auth.js This runbook covers the single-owner GitLab login used by this Next.js application. It focuses on configuration boundaries, exact …
Heroku Postgres + Drizzle Operations This runbook is for safe schema and content-data operations on the application's Heroku Postgres database. It distinguishes migrations, seed…
What Broke When I Deployed Next.js 16 to Heroku The first production deploy looked simple: build a Next.js 16 App Router project, attach Heroku Postgres, configure GitLab OAuth,…
Why Cloudflare Returned SSL Handshake Failed 525 A browser can show a secure Cloudflare certificate while Cloudflare still fails to create a secure connection to the origin. Tha…
The Localhost OAuth Redirect Bug The production login page appeared to work until the browser tried to submit the GitLab sign-in form. The form action pointed to https://localho…
Deleting Seed Data Safely in Production Seed data is useful in development and dangerous when its lifecycle is unclear. A seed script creates rows; a migration changes database …
Building an Agent-Readable Knowledge Site A documentation site can be easy for people to browse and still be awkward for agents to use. The solution is not to make agents scrape…
What I Learned from Writing a Next.js Guide for Agents Writing a framework guide for an agent is different from writing a tutorial for a person. A person can fill in context fro…
From Thai Draft to English Technical Documentation The first version of the documentation was written in Thai because that was the fastest way to capture the operational context…
Web Blog Agent Handbook This handbook is the operating manual for an agent working in the web-blog repository. It explains how to inspect the project, make scoped changes, publi…
Public Content Contract v1 This is the stable contract for published Blog, Docs, and Template content on docs.phatysd.me . It is written for agents, integrations, and maintainer…