The beautiful blog theme from Narative adapted by Tinia Labs for Next.js with blazing fast performance.
With minimal styling and maximum features — including multiple homepage layouts, built-in social sharing and dark mode — Novela makes it easy to start publishing beautiful articles and stories with Next.js.
Novela is built by the team at Narative, updated by Tinia Labs to work on Next.js, and built for everyone that loves the web.
Special thanks to @jpvalery for helping maintain the original Gatsby version of Novela.
See tinialabs/next-starter-novela for a complete starter kit that uses this theme.
Features specific to Next.js over others Next.js examples
- Favicon generator Uses the
faviconspackage to generate favicons and manifests on all required platforms - Yaml config Put all your site config in one place in a site.yml file in your content folder
- All content colocated All content including images and markdown are colocated in the
contentfolders - No CMS required Keep all your blog articles and images under version control in Github or similar
- Image optimization Use Next.js runtime image optimization without needing to know the height and width of each image
- Image lazy loading and LQIP Use blurred image placeholders (similar to Medium) without an extra server roundtrip; lazy laod images when the images are ready to be shown in the viewport
- Fast performance Much faster build times than Gatsby for the exact same blog content and layout; >95 lighthouse scores in every category currently
- Simpler project structure Instead of multiple gatsby hooks, use Next.js intuitive /pages structure for a better developer experience
See tinialabs/next-starter-novela for a complete starter kit that uses this theme.
See tinialabs/next-lib-content for logic that generates the blog articles from markdown and yaml files on disk.
Two Next.js plugins tinialabs/next-favicon-loader and tinialabs/next-meta-image-loader were hand-written to provide some of the Gatsby functionality in the original Novela theme and can now be used in any Next.js site.
-
-
With Next.js Starter Novela
-
From scratch
-
-
This guide will take you through setting up Novela with Next.js Starter Novela.
npx create-next-app -e https://github.com/tinialabs/next-starter-novelagit clone [email protected]:tinialabs/next-starter-novela.git novela-site
cd novela-site
yarnOnce installed or cloned locally and all packages are installed you can begin developing your site.
# Run localhost
yarn dev
# Build your Next.js site
yarn buildTo learn more about adding Authors, Posts, and Site Metadata see:
This guide will take you through adding Novela to a new project. You do not require any Next.js starters or similar, but you can add Novela to an existing Next.js project.
You can also view the completed example repository.
# Create an empty directory and go into it
mkdir novela-site && cd novela-site
# Add all required dependencies
yarn add react react-dom next next-theme-novelaOnce you've installed React, Next.js, and Novela you'll want to add your first Author and Post.
The recommended project structure for your content and site looks like this:
novela-site
├── .config
│ ├── .mdx-plugins.js
│ └── .next-sitemap.js
├── content
│ ├── authors
│ │ ├── avatars
│ │ │ └── avatar.jpg
│ │ └── authors.yml
│ └── posts
│ │ └── 2020-01-01-my-first-novela-post
│ │ ├── images
│ │ │ └── novela-hero.jpg
│ │ └── index.mdx
│ ├── theme
│ ├── favicon.png
│ └── site.yml
├── .meta
├── node_modules
├── next-config.js
├── package.json
├── pages
├── public
└── tsconfg.json
You must add next-theme-novela and next-lib-content as package.json dependencies or .meta sub-projects. We
use the latter in all examples
We also require next-favicon-loader and next-image-meta-loader as next.js plugins, and use next-compose-plugins to
add these to your next-config.js file. These generate the favicons/site manifest, as well as provide the ability to
import images directly from the content tree right next to the assocated markdown, instead of the Next.js default of
having to put them in the public folder.
// next-config.js
const { withPlugins } = require('next-compose-plugins');
module.exports = withPlugins(
[
require('next-favicon-loader'),
require('next-image-meta-loader'),
],
{
webpack: (config, { defaultLoaders }) => {
defaultLoaders.babel.options.plugins = [
require.resolve('@emotion/babel-plugin')
]
return config
}
}
)Once you've setup the plugins in next-config.js and installed the theme proects you can start creating your first Posts. In order to create a Post you also need at least one Author.
In step 2 we created the folder structure of our project. We can now add an Author by populating /content/authors/authors.yml:
novela-site
└── content
└── authors
├── avatars
│ └── brotzky-avatar.jpg
└── authors.yml
In authors.yml add an Author. There must be at least one featured Author.
/content/authors/authors.yml:
- name: Dennis Brotzky
bio: |
Written by Dennis Brotzky who lives and works in Vancouver building useful things.
You should follow him on Twitter.
avatar: ./avatars/brotzky-avatar.jpg
featured: true
social:
- url: https://unsplash.com
- url: https://stackoverflow.com
- url: https://github.hscsec.cnOnce you have at least one Author defined in authors.yml you can add your first Post.
Start by creating a new folder in content/posts. You can name it anything you like but we recommend including the date at the front to organize your posts. Once you've created your folder you can add an index.mdx file and an images folder.
/content/posts/2020-01-01/index.mdx
---
title: Why Narative loves Next.js
author: Dennis Brotzky
date: 2019-04-27
hero: ./images/narative-gatsby-hero.jpg
excerpt: This is a love story about Narative and Next.js
---
# And then under the heading YML you can insert any MDX you like
# like headings, links, code, images, etc
# This will show up in the body of your post
# ...In order to configure the theme to properly generate the pages and meta tags you must add specific data to siteMetadata.
The fields that are unique to Novela are hero.heading, hero.maxWidth, and social.
Add your Site Metadata to the site.yml file.
// site.yml
---
title: Novela by Tinia Labs
name: Tinia Labs & Narative
siteUrl: https://novela.tinia.vercel.app
description: This is my description that will be used in the meta tags and
important for search results
hero:
heading: Welcome to Novela, the simplest way to start publishing with Next.js.
maxWidth: 652
social:
- name: twitter
url: https://twitter.com/narative
- name: github
url: https://github.com/narative
- name: instagram
url: https://instagram.com/narative.co
- name: linkedin
url: https://www.linkedin.com/company/narative/
- name: dribbble
url: https://dribbble.com/narativestudio
blog:
copyrightYear: 2021
contentPosts: content/posts
contentAuthors: content/authors
basePath: /
authorsPage: true
pathPosts: 'a'
pathAuthors: 'authors'
pageLength: 6
sources:
local: true
contentful: false
manifest:
appName: Novela by Narative
appShortName: Novela
appDescription: Novela by Narative
start_url: /
background: "#fff"
theme_color: "#fff"
display: standalone
alwaysEmitFull: false
googleAnalytics:
trackingId: UA-118232427-3Once all steps have been completed you can run your site. In the root of your project run yarn dev.
If you ran into problems you can reference the example repository or create an issue.
With the flexibility of Next.js, Novela is able to pull different data sources to build your website. Right now we support your local file system. All data sources can be combined together or used separately.
Local is the default data source for Novela. Write MDX and YAML in order to generate posts and authors. This is the fastest and simplest way to get started.
To learn how to use the local file system, read the Installation steps.
Contentful and other cloud content management systems provide the flexibility of a headless CMS which allows you to write content without committing new files and working in a text editor. The setup process is simple if you are familiar with Contentful.
You will need to setup your Contentful space and import the Novela model.
Then fork the next-lib-content and instead of reading the posts from the file system, read them from your CMS.
This is currently beyond the scope of this Next.js starter.
Once you've created the Logo component it should automatically appear in your site.
The technique we have used is called Meta Repositories and Yarn Workspaces and is easier than Gatsby component shadowing. Just fork next-theme-novela and next-lib-content, update the .meta file, and run the install again.
By default Author pages are enabled. They can be disabled through the site option authorsPage. If you decided to enable Author pages please make sure you have all the required for each author you add.
Novela allows you to change the default theme styling by updating the theme-ui values. If you're familiar with Styled Components or Emotion it's the same as adapting the theme you pass to ThemeProvider.
Images can be added to Posts and customized to fit your content. Define a regular Markdown image that will default to Small or write HTML to customize the sizes. All images can be clicked to zoom.
<div className="Image__Small">
<img src="./images/small.jpg" alt="This is the alt text small image" />
</div>
<div className="Image__Medium">
<img src="./images/medium.jpg" alt="This is the alt text medium image" />
</div>
<div className="Image__Large">
<img src="./images/large.jpg" alt="This is the alt text large image" />
</div>| Size | Class Name | Description |
|---|---|---|
| small | Image__Small | Width of the text |
| medium | Image__Medium | Larger than width of the text |
| large | Image__Large | Full width image |
Your logo must be in SVG (vector) format in order to add it to the theme. This is required because we will be making a React component containing your SVG Logo.
Start by creating the component file at:
novela-site
└── src
└── @narative
└── gatsby-theme-novela
└── components
└── Logo
└── index.js
It is important you create the exact folder structure so Next.js knows to shadow this component. Once the file is created you can create your Logo component.
import React from 'react'
/**
* Paste in your SVG logo and return it from this component.
* Make sure you have a height set for your logo.
* It is recommended to keep the height within 25-35px.
* Logo comes with a property value called `fill`. `fill` is useful
* when you want to change your logo depending on the theme you are on.
*/
export default function Logo({ fill }) {
return (
<svg viewBox="0 0 106 28" height="30px">
<path d="M62.9 12h2.8v10...." />
<path fill={fill} d="M25 14h-..." />
<path d="M14 0C6.3..." fill="#639" />
</svg>
);
}It is recommended to use the Default options, but if your project requires something else you can configure them to your need.
| Option | Default | Description |
|---|---|---|
| contentPosts | content/posts | Define where you want to pull your Post data from |
| contentAuthors | content/authors | Define where you want to pull your Author data from |
| authorsPage | false | Create Author pages |
| authorsPath | /authors | Where should Author pages live? |
| rootPath | / | Define the index of your site |
| basePath | / | Where should the site be served from? /blog will change all paths to start with /blog |
| pageLength | 6 | How many posts should be shown per page |
| articlePermalinkFormat | :slug | Define the format of the article permalink. Possible values: :slug, :year, :month, :day. Example: :year/:month/:day/:slug |
| mailchimp | false | Enable Mailchimp subscriptions on each Post |
| sources.local | true | Enable local file system data source |
| sources.contentful | false | Enable Contentful data source |
| Key | Required | Type | Description |
|---|---|---|---|
| name | required | String | The Author's full name which is used should be used as a reference in Posts |
| bio | required | String | The Author's bio which is displayed on the home page |
| avatar | required | Image | The Author's avatar |
| featured | optional | Boolean | If true the Author will appear on the homepage |
| slug | optional | String | Override the autogenerated slug based on the Author's name. Do not include any slashes. |
| social | required | Array | A list of social accounts and urls. View supported icon/name combinations |
- name: Dennis Brotzky
bio: |
Written by You. This is where your author bio lives. Share your work, your
joys and of course, your Twitter handle.
avatar: ./avatars/dennis-brotzky.jpg
featured: true
social:
- url: https://github.com
- url: https://twitter.com
- name: Thiago Costa
bio: |
Written by You. This is where your author bio lives. Share your work, your
joys and of course, your Twitter handle.
avatar: ./avatars/thiago-costa.png| Key | Required | Type | Description |
|---|---|---|---|
| title | required | String | Used as title and generates a default slug. Must be unique. |
| slug | optional | String | Define a custom slug that will override the default title slug. |
| author | required | String Ref | Must match a defined Author name. Co-author posts by adding comma seperated Author names. |
| date | required | Date | YYYY-MM-DD format |
| hero | required | Image | 1200px minimum width recommended |
| excerpt | required | String | 140 character limit |
| subscription | optional | String | If mailchimp is enabled disable the subscription box on an individual Post |
| secret | optional | Boolean | If secret the Post will not appear in paginated lists. Defaults to false. |
# novela-site/content/posts/2020-01-01/index.mdx
---
title: Why Narative loves Next.js
author: Dennis Brotzky, Thiago Costa, Brad Tiller
date: 2019-04-27
hero: ./images/narative-gatsby-hero.jpg
excerpt: This is a love story about Narative and Next.js
---
# And then under the heading YML you can insert any MDX you like
# like headings, links, code, images, etc
# This will show up in the body of your post
# ...| Key | Required | Type | Description |
|---|---|---|---|
| title | required | String | Used for the <title></title> |
| name | required | String Ref | Used in multiple locations including meta tags and site footer |
| siteUrl | required | Date | Used in meta tags |
| description | required | String | Used in meta tags |
| hero.heading | required | String | Used in the Hero |
| hero.maxWidth | optional | number | Used in the Hero. Defaults to 652 |
| social | required | Array | View supported icon/name combinations. url is required and the icon is chosen based on the url. If you also provide name, then the icon will be the same as the name you provided as long as the name equals one of the supported icons (See example bellow). Used in site footer and meta tags |
There are many Next.js themes to choose from. Here’s why we think you won’t regret choosing Novela:
Choose between a variable width grid or a simpler list style to display each story.
Out of the box, Novela includes both light and dark designs that can be toggled by the user anywhere across the site.
Simple Customization with Theme UI
Consistent, easy-to-read code lets you quickly customize every color and setting.
High quality embedded codeblocks that make authoring technical blog posts a breeze.
Users can select text within an article to copy or share to platforms like Twitter and LinkedIn.
Read time is automatically generated for each article based on length, with an animated bar tracking the reader’s progress through each piece.
Navigable by cursor or keyboard, readable via screens and screen readers, Novela ensures everyone on the web can read what you write.
This project is early in development and we are interested in creating an even more extensible experience, and increased out-of-box functionality, including:
- Data sources such as Prismic, Sanity, Contentful, Netlify CMS, and others
- Built in search with Algolia or similar
- Tags, categories, and more
- More theme variations
- More customization options
