Home

Awesome

React CMS-powered application built with Next.js

Important Notice

This project was created as an example use case of ButterCMS with React and Next.JS, and will not be actively maintained.

If you’re interested in exploring the best, most up-to-date way to integrate Butter into javascript frameworks like React and Next.js, you can check out the following resources:

Starter Projects

The following turn-key starters are fully integrated with dynamic sample content from your ButterCMS account, including main menu, pages, blog posts, categories, and tags, all with a beautiful, custom theme with already-implemented search functionality. All of the included sample content is automatically created in your account dashboard when you sign up for a free trial of ButterCMS.

Other Resources

Project Description

Deploy with Vercel

Next.js is a small framework for building universal React webapps. Next.js comes with Webpack and Babel built-in. You can read more about the philosophy behind Next.js here.

ButterCMS is a hosted API-based CMS and blog engine that lets you build CMS-powered apps using any programming language. You can think of Butter as similar to WordPress except that you build your website in your language of choice and then plug-in the dynamic content using an API.

This projects shows how to integrate ButterCMS into Next.js application:

Link to ButterCMS API documentation is https://buttercms.com/docs/api/.

Set up ButterCMS account

  1. Create a free account on ButterCMS - https://buttercms.com/.
  2. To see the project locally you need to create this data in your account:
    • Create and publish customer case study pages (page with type customer_case_study) with this structure: customer case study page type configuration Learn more about page types here.
    • Create collection faq_items with this structure: faq items collection configuration Learn more about collections here.
  3. Find your read API token from the home page or from settings page, it will be needed later.

Requirements

Running project locally

  1. Clone and cd into project:
git clone https://github.com/ButterCMS/react-cms-blog-with-next-js.git
cd react-cms-blog-with-next-js.git
  1. Install all dependencies
npm install

or

yarn install
  1. Copy .env.example file as .env and replace BUTTER_CMS_API_KEY value with your read API token
  2. Run the app in development mode
npm run dev

or

yarn dev

The application should be available at http://localhost:3000.

To build the project run npm run build and to start run npm start

Deploy on Vercel

  1. Create a Vercel account at https://vercel.com/signup and download the CLI
  2. Run vercel at the project root

Webhooks to trigger deployment

We can make use of the ButterCMS webhooks to notify the application every time a post, page or collection item are added or modified, and reload the Next.js application.

You can add a new webhook by going to the https://buttercms.com/webhooks/ page.

webhook page

If you use Vercel, you can create deploy webhooks there. Vercel deploy webhooks

Wrap up

Next.js is a powerful framework that makes it easy to build universal React apps. With ButterCMS you can quickly build CMS-powered applications and websites with React and Node.js.

We hope you enjoyed this tutorial. If you have any questions about setting up your ButterCMS-powered application feel free to contact ButterCMS support.

Other

View ReactJS Blog engine and Full CMS for other examples of using ButterCMS with ReactJS. And check out Next.js Blog engine and Next.js CMS for other Next.js examples.