Notebook

163 entries across 18 topics. An archive of things I learned and wanted to remember, kept as they were written. The newer thinking is in the changelog.

Topics

AI25 APIS6 Architecture1 Career13 Deployments8 Design Patterns6 Docker2 GCP1 Git10 Github1 Good Code9 Laravel25 Next.js17 Observability1 PHP3 Project Docs6 React25 TypeScript4

All entries

Architecture decision records: a practical guide and templateArchitecture24 Oct Git branching strategies: Gitflow, trunk-based and GitHub FlowGit24 Oct Harness engineering for coding agentsAI24 Oct Health checks in LaravelLaravel24 Oct Logging in LaravelLaravel24 Oct Monitoring and alerting in LaravelLaravel24 Oct Props, children and component composition in ReactReact24 Oct REST API design rules for URLs, methods and fieldsAPIS24 Oct REST API response shape, pagination and errorsAPIS24 Oct REST API security, authentication and rate limitingAPIS24 Oct Running a REST API: caching, versioning, deprecation and releaseAPIS24 Oct Sharing state in React without ReduxReact24 Oct Software engineering in the age of AIAI24 Oct useState, useReducer and the mental model of state in ReactReact24 Oct What happens to developers who don't adapt to AIAI24 Oct My VPS got throttled to 20% CPU, so I'm buying a mini PC for homeAI05 Oct Why I use the CLI with Herdr instead of desktop apps and orchestratorsAI05 Oct I moved my coding agents to a VPS so I could close my laptopAI01 Oct Infrastructure questions belong before the first line of codeAI02 Aug SEO feedback should become bounded engineering workAI02 Aug Agent workflows should outlive their modelsAI27 Jul A Modern Quality Pipeline and Testing Strategy for Frontend ProjectsGood Code17 Jun Agents Are Cron Jobs and Markdown FilesAI17 Jun Measure Your Agent Skills or Delete ThemAI12 Jun What to Do If You're Not Detail OrientedCareer08 Jun How to Stay Resilient in a Difficult Engineering JobCareer06 Jun AI Code Review: Pre-Existing Bugs as a Side QuestAI01 Jun Software Factory: Build Factories, Not FeaturesAI01 Jun Small npm Packages Are Mostly DeadAI30 May The Four Levels of Working with AIAI30 May How AI Agents Made Me CLI-FirstAI27 May How I Build Software With Agent LoopsAI27 May Higher-Order Components and Why Hooks Replaced ThemReact25 May Pure Components and Why Purity Matters in ReactReact18 May React Fragments and When You Actually Need ThemReact11 May Refs and when useRef beats useStateReact07 May Default Props and Optional Props in ReactReact01 May Handling Form Submission in ReactReact30 Apr Client-side validation before Server Actions in Next.jsNext.js29 Apr Type-Safe Adapter Registries with as const and satisfiesTypeScript29 Apr Using Service Interfaces and Null Objects for Resilient TypeScript ScriptsTypeScript29 Apr Validating Multi-Provider Credentials with Zod Discriminated UnionsTypeScript27 Apr Building a URL Shortener with Next.jsNext.js22 Apr Magic Link Authentication in Next.jsAPIS22 Apr API Key Management in Next.jsAPIS21 Apr Transactional Email with Resend and React EmailNext.js21 Apr Type Annotations vs Type Inference: When to Write the TypeTypeScript21 Apr The Compound Component Pattern in ReactReact20 Apr The Render Prop Pattern in ReactReact20 Apr Dynamic OG Images in Next.js with opengraph-image.tsxNext.js17 Apr Conditional Rendering Patterns in ReactReact16 Apr Lists and Keys in React: Why They Actually MatterReact15 Apr Why Dyslexia Made Me a Better Software EngineerCareer15 Apr Event Handling in ReactReact14 Apr Git Commands for Reading New CodebasesGit14 Apr Extracting a Queries Layer from Next.js Server ComponentsNext.js12 Apr The Virtual DOM and How React Reconciliation WorksReact12 Apr Avoiding Unnecessary Rerenders in ReactReact08 Apr Controlled vs Uncontrolled Forms in ReactReact08 Apr Custom Hooks: Naming and StructureReact08 Apr Deploying Next.js to Cloudflare PagesNext.js08 Apr Error and Not-Found Pages in the App RouterNext.js08 Apr Fetching Data in Server ComponentsNext.js08 Apr generateStaticParams and Static ExportNext.js08 Apr Image Optimisation in Next.jsNext.js08 Apr Incremental Static Regeneration ExplainedNext.js08 Apr Middleware Patterns in Next.jsNext.js08 Apr React Error Boundaries in PracticeReact08 Apr React Server Components vs Client ComponentsReact08 Apr React Suspense: loading fallbacks, boundaries and use()React08 Apr Route Handlers vs Server ActionsNext.js08 Apr Server Actions in Next.js 15Next.js08 Apr Streaming and Suspense in Next.jsNext.js08 Apr Structuring Large React AppsReact08 Apr Testing React Components with Vitest and Testing LibraryReact08 Apr The Metadata API and SEO in Next.jsNext.js08 Apr The Next.js App Router Mental ModelNext.js08 Apr useEffect Mistakes I Stopped MakingReact08 Apr When to Use useMemo and useCallbackReact08 Apr Docker Compose HealthchecksDocker31 Mar Template Method Design PatternDesign Patterns31 Mar Testing in LaravelLaravel27 Mar LinkedIn ProfileCareer20 Mar AI Job InterviewsAI19 Mar Everything Is Markdown NowAI19 Mar SaaS vs Open Source in the Age of AI CodingCareer19 Mar A Reusable PRD Framework for Standard SaaS FeaturesProject Docs17 Mar Project SpecProject Docs17 Mar Website Go Live ChecklistDeployments17 Mar Adapter Design PatternDesign Patterns16 Mar AI RulesAI16 Mar Contextual Attributes in LaravelLaravel16 Mar GitHub ProfileCareer16 Mar Laravel Pint: configuration, rules and CI checksLaravel16 Mar Rector: Automated PHP Code RefactoringPHP16 Mar Scheduled Tasks in LaravelLaravel16 Mar Security Headers in LaravelLaravel16 Mar Agent SkillsAI13 Mar Claude Sub-AgentsAI13 Mar PHPStan: Static Analysis for PHPPHP08 Mar Rate Limiting in LaravelLaravel08 Mar CLAUDE.md FileAI07 Mar Builder Design PatternDesign Patterns05 Mar CI/CDDeployments05 Mar ContainerisationDeployments05 Mar Managing Cognitive Load in CodeGood Code05 Mar A/B Testing DeploymentsDeployments02 Mar Actions Pattern in PHPGood Code02 Mar Architecture DocumentationProject Docs02 Mar Avoiding N+1 Queries in LaravelLaravel02 Mar Blue/Green DeploymentDeployments02 Mar Bridge Design PatternDesign Patterns02 Mar Cache Invalidation Strategies in LaravelLaravel02 Mar Caching in LaravelLaravel02 Mar Canary DeploymentDeployments02 Mar CarbonImmutable in Laravel: prevent date mutation bugsLaravel02 Mar Change the Origin of a Git RepositoryGit02 Mar ChangelogProject Docs02 Mar Choosing the Right Company Size as a Software EngineerCareer02 Mar Clean Up DockerDocker02 Mar Create a Brag DocumentCareer02 Mar Creating a Software Developer CVCareer02 Mar Creating Pull RequestsGit02 Mar Custom Collections in LaravelLaravel02 Mar Data Transfer Objects (DTO)Good Code02 Mar Domain-Driven DesignGood Code02 Mar Eloquent Builder vs Scopes in LaravelLaravel02 Mar End of Contract ChecklistCareer02 Mar EnvironmentsProject Docs02 Mar Feature TogglesDeployments02 Mar Form Request Validation Patterns in LaravelLaravel02 Mar FreelancingCareer02 Mar GCP VM Port ForwardingGCP02 Mar Git HooksGit02 Mar GitHub Copilot Instructions TemplateAI02 Mar Infrastructure as CodeDeployments02 Mar InterviewingCareer02 Mar Laravel Coding StandardsLaravel02 Mar Mass Assignment Guarding in LaravelLaravel02 Mar Performance Improvements in LaravelLaravel02 Mar Permanent vs ContractingCareer02 Mar PHP Coding StandardsPHP02 Mar Pull Request TemplateGithub02 Mar Queues in LaravelLaravel02 Mar Read/Write Database Splitting in LaravelLaravel02 Mar Repository PatternGood Code02 Mar Reviewing Pull RequestsGit02 Mar Route Organisation and Naming in LaravelLaravel02 Mar Runbook TemplateObservability02 Mar Secrets and Config Validation in LaravelLaravel02 Mar SOLID PrinciplesGood Code02 Mar Spec-Driven Development with AIAI02 Mar Stacked Pull RequestsGit02 Mar State Design PatternDesign Patterns02 Mar Strategy Design PatternDesign Patterns02 Mar Tech Stack DocumentProject Docs02 Mar The Twelve-Factor AppGood Code02 Mar Using .env in LaravelLaravel02 Mar Using Multiple SSH KeysGit02 Mar Value ObjectsGood Code02 Mar VersioningGit02 Mar Working with Large Datasets in LaravelLaravel02 Mar Writing Good Commit MessagesGit02 Mar