Go HTTP Service Foundations
Go HTTP Service Foundations Go's standard library is enough to build a small HTTP service with a clear runtime boundary. The useful starting point is not a framework decision. It is an explicit module, a small handler…
Public discovery / published only
Search words, narrow by content type, or follow topics in the hierarchy. This surface intentionally excludes drafts and archived items.
Go HTTP Service Foundations Go's standard library is enough to build a small HTTP service with a clear runtime boundary. The useful starting point is not a framework decision. It is an explicit module, a small handler…
Fiber Production API Runbook Fiber is useful when a Go service needs a concise routing and middleware model with a fast HTTP implementation. A production Fiber service still needs explicit ownership for process lifecy…
NestJS Feature Module Runbook NestJS gives a service a strong application structure through modules, controllers, and providers. Use that structure to make ownership visible: controllers translate transport input, pro…
NestJS Modules Are the Boundary NestJS can look like a collection of decorators when you first open a project. The more useful mental model is a graph of feature modules. Each module says which controllers and provide…
Fiber Performance Is a Boundary, Not a Personality Fiber makes a Go API feel familiar if you have used an Express-style routing model. That familiarity is valuable, but the word "fast" can create the wrong engineering…
Why Go Keeps HTTP Services Small The first surprise in a Go HTTP service is how little framework is required. net/http gives you handlers, a multiplexer, a server, and a testable seam. That simplicity is useful, but i…
Museum Catalog Minimal Museum Catalog Minimal gives collections room to speak. The interface is a quiet frame for objects, provenance, and the small details that reward close attention. Use it when Use it for exhibiti…
Editorial Paper Notes Editorial Paper Notes treats reading as a physical-feeling experience without turning the interface into a literal skeuomorph. The direction works best when the content has a considered voice and…
Quiet SaaS Dashboard Quiet SaaS Dashboard is built for repeated work. It gives hierarchy and feedback enough space to be understood quickly, while keeping the visual surface calm during long sessions. Use it when Use …
Bold Creative Studio Bold Creative Studio makes a point of view visible immediately. It is a flexible direction for work that should feel authored rather than assembled from neutral product patterns. Use it when Choos…
Warm Community Handbook Warm Community Handbook makes guidance feel like an invitation. It is especially effective when the audience is arriving with uncertainty and needs to understand both the rules and the people b…
Dark Developer Toolkit Dark Developer Toolkit gives technical work a focused home. Its visual language should recede behind code, logs, and system state while still making important changes easy to notice. Use it when…
Neo-Brutalist Launchpad Neo-Brutalist Launchpad is intentionally obvious. It turns a launch page into a poster-like statement with strong edges, direct language, and one action that is hard to miss. Use it when Use it…
Soft Utility Mobile Soft Utility Mobile is designed around the small repeated actions that make a product useful. It uses gentle surfaces and clear touch feedback to make everyday work feel manageable. Use it when Cho…
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 maintainers who need to discover and consume conte…
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. That is the key to understanding Error 525.…
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, and put Cloudflare in front of the cust…
Next.js 16 Caching Patterns Caching is a data-lifecycle decision, not a decoration added after a page is slow. For every query, an agent should know whether data is request-time, prerendered, shared, private, time-rev…
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 data, content publishing, backups, and …
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 callback URLs, and the failure mode wher…
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 domain. Use placeholders in commands; never…
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 structure. Treating them as the same thi…
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 the visual page. It is to publish a sta…
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 from experience. An agent needs boundaries,…
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. The published audience, however, inclu…
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://localhost:<internal-port /api/auth/signin/gitla…
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, publish content, and prove that the result wo…
Next.js 16 for Agents: A Verifiable, Production-Ready App Router Guide Research snapshot: 2026-09-19 Asia/Bangkok Repository target: web-blog Installed version observed in this repository: next@16.3.5 Official documen…