Nuxt Content + Netlify CMS Starter Blog

Note: This starter uses Nuxt 2.14 and @nuxt/content v1.1.0. This is a port of the Gatsby + Netlify CMS Starter.

This repo contains an example business website that is built with Nuxt.js, @nuxt/content, and Netlify CMS: Demo Link.

It follows the Jamstack architecture by using Git as a single source of truth, and Netlify for continuous deployment, and CDN distribution.

Features

A simple landing page with blog functionality built with Netlify CMS and @nuxt/content
Editable Pages: Landing, About, Product, Blog-Collection and Contact page with Netlify Form support
Create Blog posts from Netlify CMS
Tags: Separate page for posts under each tag
Basic directory organization
Uses TailwindCSS for styling from the @nuxtjs/tailwindcss module, with PurgeCSS included for minimal CSS.
@tailwind/typography configured for prose and responsive prose.
Blazing fast loading times thanks to server-side rendering in full static mode.
Separate components for everything
Netlify deploy configuration
..and more

Sites Based On This

Vonage Learn - Developer Education Platform for Vonage.com
Hacktoberfest Ninja - Unofficial Hacktoberfest Site for Repo Tracking and Rules

Prerequisites

Node (I recommend using v8.2.0 or higher)
Nuxt
Netlify CLI

Getting Started (Recommended)

Netlify CMS can run in any frontend web environment, but the quickest way to try it out is by running it on a pre-configured starter site with Netlify. Use the button below to build and deploy your own copy of the repository:

After clicking that button, you’ll authenticate with GitHub and choose a repository name. Netlify will then automatically create a repository in your GitHub account with a copy of the files from the template. Next, it will build and deploy the new site on Netlify, bringing you to the site dashboard when the build is complete. Next, you’ll need to set up Netlify’s Identity service to authorize users to log in to the CMS.

Access Locally

Pulldown a local copy of the Github repository Netlify created for you, with the name you specified in the previous step

git clone https://github.com/[GITHUB_USERNAME]/[REPO_NAME].git
cd [REPO_NAME]
npm install
netlify dev # or ntl dev

This uses the new Netlify Dev CLI feature to serve any functions you have in the lambda folder.

To test the CMS locally, you'll need to run a production build of the site:

netlify dev # or ntl dev

Getting Started (Without Netlify)

git clone https://github.com/lukeocodes/gatsby-starter-netlify-cms/ [SITE_DIRECTORY_NAME]
cd [SITE_DIRECTORY_NAME]
npm install

# dev start
npm run dev

# prod build and start
npm run generate
npm run start

Setting up the CMS

Follow the Netlify CMS Quick Start Guide to set up authentication, and hosting.

Debugging

Windows users might encounter node-gyp errors when trying to npm install. To resolve, make sure that you have both Python 2.7 and the Visual C++ build environment installed.

npm config set python python2.7
npm install --global --production windows-build-tools

Full details here

MacOS users might also encounter some errors, for more info check node-gyp. We recommend using the latest stable node version.

Contributing

Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct. Then, check out the contributing guidelines.

ArnaudSau/nuxt-starter-test