Developer ExperienceContent Modelling
Generated types are a contract, not a convenience
Types written by hand describe what you believed the schema said. Types generated from it describe what the schema actually says.
Avery LinBlog
Notes on content modelling, performance, theming and developer experience — written while building this starter. Filter by category, or search the titles and summaries.
Avery Lin
Developer ExperiencePerformance
Draft preview without shipping a token to every visitor
A read token in the browser bundle is readable by everyone who loads the page. Preview does not need one — the Studio is already logged in.
Jordan Hale
Design SystemsPerformance
Dark mode is a second axis, not a second stylesheet
The server cannot know which colour scheme a visitor prefers. Anything you render that depends on it will hydrate differently than it painted.
Priya Raman
Design SystemsContent Modelling
Theme colours belong to the content, not the stylesheet
When an editor picks a brand colour, half a dozen derived values have to stay legible. Here is how to derive them once instead of hard-coding them everywhere.
Avery Lin
Performance
Static generation is a caching strategy, not an architecture
Prerendering makes a site fast and cheap. It also quietly bakes every assumption your code makes about the request into the HTML you ship.
Jordan Hale
Content Modelling
Why your CMS should not know what a hero section is
Page-shaped content models feel productive for about six weeks. Here is what to model instead, and how to tell when a field is describing meaning rather than layout.
Avery Lin
Developer ExperienceDesign Systems
A scaffolder is documentation that runs
Any component that needs six files in five directories will be built wrong by hand eventually. Generating it is cheaper than writing the guide twice.
Priya Raman