Welcome to the Notion Blog Template

A complete getting-started guide: duplicate the Notion database, fork the repo, configure environment variables, and publish your first post in under an hour.

Why this template exists

This starter gives you a production-shaped blog without running a separate CMS server. You write in Notion, deploy on Vercel, and get SEO metadata, RSS, category pages, tag pages, and an optional about page out of the box.

The template intentionally omits ads, server-side analytics, and self-hosted comment backends. Those are advanced concerns you can add to your own fork later.

📋

Duplicate the public Notion template linked in the README before you start. You will receive a new database ID in your workspace — never paste someone else’s ID into production.

What you need

A GitHub account to fork or use the template repository
A Notion account and a duplicated template database
A Notion internal integration with Read content access
A Vercel account (Hobby tier is fine for personal blogs)

High-level workflow

Fork the repository, connect your Notion integration to your duplicated database, copy NOTION_TOKEN and NOTION_DATABASE_ID into Vercel, set NEXT_PUBLIC_SITE_URL to your domain, and deploy. The site revalidates post listings every 60 seconds via ISR.

First deploy checklist

Connect integration to the posts database in Notion
Set status to Public and type to Post on every published article
Add a slug for each post (or let the app derive one from the title)
Replace og.png and portrait.png in public/static/images/

Next steps

Read the deployment guide and customization articles in this demo feed. Each post mirrors a real section of the documentation you will maintain in your own Notion workspace.

“
Treat Notion as your editorial desk and Next.js as your printing press — the template is the binding between them.