- Notifications
You must be signed in to change notification settings - Fork205
Publish flaring fast blogs with Next.js and Ghost CMS
License
styxlab/next-cms-ghost
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Create and publish flaring fast blogs withnext-cms-ghost. Powered by the React framework Next.js and content fed by headless Ghost, you'll get a production ready hybrid frontend that combines the best of static and server-rendered sites. Most importantly, your website can be easily distributed globally to be served from the edge. At the same time your content creators can continue to work with the Ghost authoring system they are used to.
Ghost CMS integration
- Supports Ghost `v3` and `v4`
Ghost Casper look & feel
- Infinite scroll
- Fully responsive
- Sticky navigation headers
- Hover on author avatar
- Styled 404 page
- Preview Section in posts
- Sitemap
- RSS feed
- SEO optimized
Extened Casper Styles ✨
- Dark Mode
- Featured posts pinned on top
- Customizable navigation headers
- Zoom images on click to full-screen
- Render GitHub Gists
Images with Next/Images 🚀
- Feature and inline images
- Auto-optimized images
- No content shifts due to consistent placeholders
Advanced Routing
- Auto-detects custom paths
- Configurable collections
Developer friendly
- MIT licenced
- Truly open-source
- Easy to contribute
- Made typesafe with TypeScript
Integrated Plugins
- Member Subscriptions
- Commenting with Commento or Disqus
- Syntax highlighting with PrismJS
- Table Of Contents
- Contact Page with built-in notification service
- Google Analytics
NextJS Features
- Incremental Regeneration
- Support for Preview
Scores calculated with Lighthouse 6.4.0.
git clone https://github.com/styxlab/next-cms-ghost.gitcd next-cms-ghostyarn# Developmentyarn dev# Productionyarn build
TheIMAGE_DOMAINS
environment variable must contain a comma separated list of all domains that you use for in-sourcing images. For example:
IMAGE_DOMAINS=res.cloudinary.com,yoursource.imgix.net
Image optimization is automatically turned off when deploying to Netlify, because it is currently on supported on Netlify.
TheSITE_URL
environment variable should be set to the public facing URL of your site, in most cases to your custom domain.
Key | Value (example) |
---|---|
SITE_URL | https://www.your-blog.org |
If you don't specifySITE_URL
, it will get populated according to the following defaults:
Platform | System Value | Conditions |
---|---|---|
Vercel | VERCEL_URL | Automatically expose System Environment Variables must be checked |
Netlify | URL |
In all other casesSITE_URL
is set tohttp://localhost:3000
.
All content is sourced from a Ghost CMS. Choose the method according to your build scenario.
Create a new text file.env.local
in the project root folder with the following content:
CMS_GHOST_API_URL=http://localhost:2368CMS_GHOST_API_KEY=9fccdb0e4ea5b572e2e5b92942
ChangeCMS_GHOST_API_URL
andCMS_GHOST_API_KEY
with the values that you can generate in your Ghost Admin underIntegrations
.
If you build your project with a cloud provider, the best option is to provide the keys with environment variables:
Key | Value (example) |
---|---|
CMS_GHOST_API_URL | https://your-ghost-cms.org |
CMS_GHOST_API_KEY | 9fccdb0e4ea5b572e2e5b92942 |
For best results, deploying to Vercel is recommended. As an alternative, you can also deploy to Netlify.
For best SEO results it is strongly recommended to disable the default Ghost Handlebars theme front-end by selecting theMake this site private flag within your Ghost admin settings.
Please report all bugs and issues atnext-cms-ghost/issues.
PRs are welcome! Consider contributing to this project if you want to make a better web.
Special thanks goes to these wonderful people (emoji key):
This project follows theall-contributors specification. Contributions of any kind welcome!
This project is not affiliated withNextJS orGhost.
Copyright (c) 2020 - 2021 styxlab - Released under theMIT license.
About
Publish flaring fast blogs with Next.js and Ghost CMS