Deploy to Vercel in Ten Minutes

Step-by-step Vercel deployment: import the GitHub repo, configure environment variables, set your production URL, and verify RSS, sitemap, and Open Graph tags.

Import the repository

In the Vercel dashboard, click Add New → Project, import your fork of notion-blog-template, and keep the root directory as /. The framework preset should detect Next.js automatically.

Required environment variables

bash

NOTION_TOKEN=secret_xxxxxxxx
NOTION_DATABASE_ID=your-duplicated-database-id
NEXT_PUBLIC_SITE_URL=https://your-domain.com
NEXT_PUBLIC_DEMO_MODE=false

NEXT_PUBLIC_SITE_URL must match your canonical domain. It drives Open Graph URLs, RSS links, JSON-LD, and the sitemap. On preview deployments, Vercel injects VERCEL_URL as a fallback.

Optional variables

NEXT_PUBLIC_GISCUS_* for GitHub Discussions comments
NOTION_PROJECT_DATABASE_ID for portfolio projects on /me

Post-deploy verification

Home page lists Public posts from Notion
/feed.xml returns RSS with absolute URLs
/sitemap.xml includes posts, tags, and categories
View source on a post page — JSON-LD BlogPosting should be present

🔍

Update public/robots.txt with your Host and Sitemap lines after the first production deploy.

Custom domain

Add your domain under Project Settings → Domains, follow DNS instructions, and update NEXT_PUBLIC_SITE_URL if you change the canonical host. Redeploy once after env changes.