finds.dev← search

// the find

transitive-bullshit/nextjs-notion-starter-kit

★ 7,020 · TypeScript · MIT · updated Mar 2026

Deploy your own Notion-powered website in minutes with Next.js and Vercel.

A Next.js starter that uses Notion as a CMS, rendering your public Notion pages as a website deployed on Vercel. It's a real project the author runs their own blog on, which at least means it's been used in anger rather than being pure demo-ware.

The single config file approach (site.config.ts) genuinely reduces setup friction — you change rootNotionPageId and you're done. Preview image generation with lqip-modern gives smooth lazy loading without any manual work. The scrollspy table of contents is a nice detail that most blog starters skip. Dev vs prod URL slugging (ID-suffixed in dev, clean in prod) is a practical choice that makes debugging easier without uglifying production URLs.

The Notion API dependency is load-bearing and unofficial — react-notion-x reverse-engineers Notion's private API, so any Notion update can silently break rendering. Redis is required for preview image caching to be tolerable at scale, adding infrastructure overhead for what should be a simple blog. URL redirects for renamed pages are left entirely to the user; if you rename a Notion page, old links break and there's no built-in solution. The repo has 5,695 forks and 7,020 stars but commits have slowed significantly — last push was March 2026 and the dependency tree (Next.js Pages Router, not App Router) is showing its age.

View on GitHub → Homepage ↗

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →