← All case studies
Case study · 2026

Notion-to-Site

Use Notion as the editor. Keep the website in your repository.

Sync content to Markdown, MDX, or JSON. Build with Next.js, Astro, SvelteKit, or any stack that reads files.

Editor

Notion as a CMS, without hosting your site on Notion

Write in Notion.
Sync to local Markdown, MDX, or JSON.

Output

Local files.
Your site.
Your workflow.

M↓.md
MDX.mdx
{ }.json
Next.jsAstroSvelteKitAny stack that reads files

Notion is a good editor.
It should not own the website.

notion-to-site keeps the writing workflow in Notion.
It keeps the site in code.

Library

One sync engine, many site shapes.

The CLI turns a Notion database into Markdown, MDX, or JSON with typed metadata.

Starter

A full bilingual site.

Home, services, about, blog, contact, SEO, and a contact form ship together.

Reference site

A real site consumes the package from npm.

Nearscale is the working reference path. Notion writes. The repository ships.

The problem

Most Notion website tools make the builder the center of the system.

The writer gets a familiar editor. The site owner gives up control over code, design, hosting, and deployment.

What shipped

Small pieces. Clear jobs. A reusable path.

Library

Open-source npm package and CLI.

nts

Init, sync, templates, types, validation, status, watch, and migration checks.

Next.js integration

Sync at build time. Read local content at runtime.

Starter

Bilingual Next.js 16 template with SEO, blog, contact form, and Vercel path.

Reference site

Nearscale consumes the package from npm.

Tests

144 tests across sync, schemas, images, templates, adapters, and rendering.

How it works

The site does not need to call Notion at runtime.

Notion database
nts or withNotion()
Local content files
Typed schema
Next.js routes
Vercel deployment

Design system

The starter is not a blank Tailwind scaffold.

It has tokens, fonts, logo, dictionaries, and site config.

Proof

Captured from the built starter running locally in production mode.

English home page
English home
English services page
English services
English about page
English about
English blog index
English blog
English contact page
English contact
English welcome article
English article
English Notion blocks article
English rich blocks article
Spanish home page
Spanish home
Spanish services page
Spanish services
Spanish about page
Spanish about
Spanish blog index
Spanish blog
Spanish contact page
Spanish contact
Spanish welcome article
Spanish article
Spanish Notion blocks article
Spanish rich blocks article

Artifacts

Repos, package, starter, and reference site.