11.9K ·GitHub
What is this?
NotionNext is an open-source site system built on Next.js and the Notion API: you keep managing posts, categories, tags and menus in Notion, and it publishes that workspace as a fast, searchable, standalone website.
NotionNext is an open-source site system built on Next.js and the Notion API: you keep managing posts, categories, tags and menus in Notion, and it publishes that workspace as a fast, searchable, standalone website.I can publish Notion pages publicly anyway — what does NotionNext add?A public Notion page is just a document. NotionNext turns the workspace into a real standalone site with your own domain, SEO, sitemap, RSS, comments, analytics, search and email subscription — built for long-term operation.
A public Notion page is just a document. NotionNext turns the workspace into a real standalone site with your own domain, SEO, sitemap, RSS, comments, analytics, search and email subscription — built for long-term operation.How do I get my first site online?Copy the official NotionNext Notion template, fork this repo to your GitHub account, deploy it on Vercel, and put your Notion page ID into the environment variables — the README bills this as a 20-minute route.
Copy the official NotionNext Notion template, fork this repo to your GitHub account, deploy it on Vercel, and put your Notion page ID into the environment variables — the README bills this as a 20-minute route.What do I need installed to run or customize it locally?Node 22 and Yarn 1. Node 20 can no longer install the dependencies because one package requires Node >=22, and your deploy platform needs to be set to Node 22 as well. Then yarn dev to develop, yarn build for production, or yarn export for a static build.
Node 22 and Yarn 1. Node 20 can no longer install the dependencies because one package requires Node >=22, and your deploy platform needs to be set to Node 22 as well. Then yarn dev to develop, yarn build for production, or yarn export for a static build.If I build my site this way, am I locked into Notion?No. Notion handles content while the site handles display and distribution, and the README notes you can later migrate to Markdown or another system.
No. Notion handles content while the site handles display and distribution, and the README notes you can later migrate to Markdown or another system.I'm not a blogger — what else can I build with it?The 26 built-in themes cover blogs, documentation and knowledge bases, portfolios, product sites, photo galleries and navigation or link-directory sites — each scenario has recommended themes in the README.
The 26 built-in themes cover blogs, documentation and knowledge bases, portfolios, product sites, photo galleries and navigation or link-directory sites — each scenario has recommended themes in the README.Which themes should I look at first?For blogs start with simple, hexo, nobelium or typography; for docs and knowledge bases use gitbook, claude or thoughtlite. opc, proxio, starter and landing fit portfolios and product sites, photo and plog target photography, and nav builds link-directory sites. You can preview and switch themes online at preview.tangly1024.com.
For blogs start with simple, hexo, nobelium or typography; for docs and knowledge bases use gitbook, claude or thoughtlite. opc, proxio, starter and landing fit portfolios and product sites, photo and plog target photography, and nav builds link-directory sites. You can preview and switch themes online at preview.tangly1024.com.Why keep writing in Notion instead of Markdown files?So you never switch writing tools: posts, categories, tags, covers and menus stay in Notion while NotionNext handles publishing. It grew out of Craig Hart's Nobelium project, which the README credits as its origin.
So you never switch writing tools: posts, categories, tags, covers and menus stay in Notion while NotionNext handles publishing. It grew out of Craig Hart's Nobelium project, which the README credits as its origin.Can it run anywhere besides Vercel?Yes. Zeabur is listed alongside Vercel as a deployment target, the repo builds a Docker image in CI, and yarn export produces a fully static build you can host on any static server.
Yes. Zeabur is listed alongside Vercel as a deployment target, the repo builds a Docker image in CI, and yarn export produces a fully static build you can host on any static server.What third-party services does it integrate with?The README names five comment systems: Twikoo, Giscus, Gitalk, Cusdis and Utterances. The dependencies also include Algolia for site search, Clerk for user accounts, Supabase and Vercel Analytics.
The README names five comment systems: Twikoo, Giscus, Gitalk, Cusdis and Utterances. The dependencies also include Algolia for site search, Clerk for user accounts, Supabase and Vercel Analytics.What are similar projects?tailwind-nextjs-starter-blog, beautiful-jekyll, nextra, jekyll-theme-chirpy, cheatsheets, hugo-PaperMod, zola, sales-crm
tailwind-nextjs-starter-blog, beautiful-jekyll, nextra, jekyll-theme-chirpy, cheatsheets, hugo-PaperMod, zola, sales-crm