A Next.js Blog with a Native Authoring Experience
This starter is a statically generated blog that uses Next.js for the frontend and Sanity to handle its content. It comes with a native Sanity Studio that offers features like real-time collaboration, instant side-by-side content previews, and intuitive editing.
The Studio connects to Sanity Content Lake, which gives you hosted content APIs with a flexible query language, on-demand image transformations, powerful patching, and more. You can use this starter to kick-start a blog or learn these technologies.
Note
This starter uses the /pages
directory for Next.js routing.
The template will be migrated to the currently experimental /app directory when Vercel announce that it is production ready.
Features
- A performant, static blog with editable posts, authors, and site settings
- A native and customizable authoring environment, accessible on
yourblog.com/studio
- Real-time and collaborative content editing with fine-grained revision history
- Side-by-side instant content preview that works across your whole site
- Support for block content and the most advanced custom fields capability in the industry
- Webhook-triggered Incremental Static Revalidation; no need to wait for a rebuild to publish new content
- Free and boosted Sanity project with unlimited admin users, free content updates, and pay-as-you-go for API overages
- A project with starter-friendly and not too heavy-handed TypeScript and Tailwind.css
Table of Contents
Project Overview
Blog | Studio |
---|---|
Important files and folders
File(s) | Description |
---|---|
sanity.config.ts |
 Config file for Sanity Studio |
sanity.cli.ts |
 Config file for Sanity CLI |
/pages/studio/[[...index]].tsx |
 Where Sanity Studio is mounted |
/pages/api/revalidate.ts |
 Serverless route for triggering ISR |
/pages/api/draft.ts |
 Serverless route for triggering Draft mode |
/schemas |
 Where Sanity Studio gets its content types from |
/plugins |
 Where the advanced Sanity Studio customization is setup |
/lib/sanity.api.ts ,/lib/sanity.image.ts |
Configuration for the Sanity Content Lake client |
/components/PreviewProvider.tsx |
Configuration for the live Preview Mode |
Configuration
Step 1. Set up the environment
Use the Deploy Button below. It will let you deploy the starter using Vercel as well as connect it to your Sanity Content Lake using the Sanity Vercel Integration.
Step 2. Set up the project locally
Clone the repository that was created for you on your GitHub account. Once cloned, run the following command from the project's root directory:
npx vercel link
Download the environment variables needed to connect Next.js and the Studio to your Sanity project:
npx vercel env pull
Step 3. Run Next.js locally in development mode
npm install && npm run dev
When you run this development server, the changes you make in your frontend and studio configuration will be applied live using hot reloading.
Your blog should be up and running on http://localhost:3000! You can create and edit content on http://localhost:3000/studio.
Step 4. Deploy to production
To deploy your changes to production you use git
:
git add .
git commit
git push
Alternatively, you can deploy without a git
hosting provider using the Vercel CLI:
npx vercel --prod
Questions and Answers
It doesn't work! Where can I get help?
In case of any issues or questions, you can post:
How can I remove the "Next steps" block from my blog?
You can remove it by deleting the IntroTemplate
component in /components/IndexPage.tsx
.
How can I set up Incremental Static Revalidation?
Go to the serverless function code in /pages/api/revalidate.ts
. In the code comments, you'll find instructions for how to set up ISR.