This example was built with an older version of Next.js. For examples using more recent versions of Next and other frameworks, please see our most current demos and starter kits.
This example showcases a Next.js Blog using DatoCMS as the data source. It fully supports Preview Mode with DatoCMS real-time updates.
The purpose of this repo is to have a quick start reference that can be set up with the "one-click" button below.
Have a look at the end result live:
Make sure that you have set up the Github integration on Vercel.
Let DatoCMS set everything up for you clicking this button:
Once the setup of the project and repo is done, clone the repo locally.
In your DatoCMS' project, go to the Settings menu at the top and click API tokens.
Then click Read-only API token and copy the token.
Next, copy the .env.example
file in this directory to .env
(which will be ignored by Git):
Then set each variable on .env
:
NEXT_EXAMPLE_CMS_DATOCMS_API_TOKEN
should be the API token you just copied.NEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET
can be any random string (but avoid spaces), like MY_SECRET
- this is used for the Preview Mode](https://www.datocms.com/docs/next-js/setting-up-next-js-preview-mode).Your .env
file should look like this:
1NEXT_EXAMPLE_CMS_DATOCMS_API_TOKEN=...2NEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET=...
1npm install2npm run dev
Your blog should be up and running on http://localhost:3000!
On DatoCMS, go to one of the posts you've created and:
[Draft]
in front of the title.(If it doesn't become draft, you need to go to the model settings for Post
, go to Additional Settings, and turn on Enable draft/published system.)
Now, if you go to the post page on localhost, you won't see the updated title. However, if you use the Preview Mode, you'll be able to see the change (Documentation).
To enable the Preview Mode, go to this URL:
1http://localhost:3000/api/preview?secret=<secret>
<secret>
should be the string you entered for NEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET
.<slug>
should be the post's slug
attribute (you can check on DatoCMS).You should now be able to see the updated title. To exit the preview mode, you can click Click here to exit preview mode at the top.