Mintlify's Technical Solution to Eliminate Cold Starts for 72M Monthly Documentation Page Views
By
skeptrune
5mo ago· 8 min readen
100/100
Golden Brown
Bagelometer↗
Master baker tier. Every paragraph earns its place on the tray.
Score100Typehow-toSentimentpositive
Summary
Mintlify, a documentation platform serving 72 million monthly page views, faced performance issues with nearly 25% of visitors experiencing slow cold starts when accessing documentation pages. The company's existing Next.js ISR caching couldn't keep up with their rapid deployment velocity (multiple times per day), as each deployment invalidated the entire cache across all customer sites. The article details their technical solution to eliminate cold starts and improve page speed performance across their documentation platform.
Key quotes
· 4 pulledMintlify powers documentation for tens of thousands of developer sites, serving 72 million monthly page views.
Nearly one in four visitors experienced slow cold starts when accessing documentation pages.
Our existing Next.js ISR caching solution could not keep up with deployment velocity that kept climbing as our engineering team grew.
We ship code updates multiple times per day and each deployment invalidated the entire cache across all customer sites.
How we improved page speed performance across Mintlify documentation.
