Welcome to the Blog Starter Kit for Contento

This starter kit has a page builder template, header and footer navs, a basic collection of composable content blocks and all you need for a blog. It’s designed to get you started using Contento, and is built with a familiar and popular tech stack (Next.js & Tailwind CSS).

Getting Started

First, install all the required dependencies:

npm install

Then, rename the .env.sample file to .env.

In your Contento Account Settings create a new API Key for this site, copy the value given to you in the dialog and then paste it into your .env file as the value of the CONTENTO_API_KEY key.

Now navigate to the Sites screen, and find your new site. Copy the ID of it from here, and paste it into your .env as the value of the CONTENTO_SITE_ID key.

Next, load up your new site by clicking on it in the Sites screen, and then navigate to the Content panel. Click into the Main Nav and copy the ID from the right hand side panel. Paste this into your .env as the value of the SITE_MAIN_NAV_ID key. Do the same for the Footer Nav, and paste it as the value of the SITE_FOOTER_NAV_ID key.

At this point, you can run the development server and get coding:

npm run dev

Open http://localhost:3000 with your browser to see the result.

Deploy on Vercel

The easiest way to deploy this repo is to use the Vercel Platform from the creators of Next.js.

Check out the Next.js deployment documentation for more details.

Once deployed, make sure to update the domain name in your Site Settings.

Visual Preview

This project is pre-configured work with the Contento Visual Preview, simply go to the Site Settings > Preview page, copy the value of the auto-generated secret and add it into your .env as the value of the CONTENTO_PREVIEW_SECRET key.

You can use the Preview panel within Contento whilst you are developing the site as we have configured the preview settings to use http://localhost:3000 for the preview URL.

Once you have your site deployed however you will want to change this to your production domain so that your content editors can use it.

Learn More

To learn more about the tools we’ve used in this repo, take a look at the following resources:

• Next.js Documentation - the React framework we use to produce a static site.
• Tailwind CSS Documentation - the CSS framework we use.
• Vercel - a simple way to deploy a Next.js site.