-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update README.md and add style for heading in content block
- Loading branch information
Showing
6 changed files
with
182 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
126 changes: 126 additions & 0 deletions
126
_posts/2020-06-01-nextjs-blog-boilerplate-presentation.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,126 @@ | ||
--- | ||
title: 'Next.js blog Boilerplate Presentation' | ||
description: Everything you need to use this Nextjs Boilerplate template | ||
date: '2020-06-01' | ||
modified_date: '2020-06-01' | ||
image: /assets/images/posts/random-img.jpg | ||
--- | ||
|
||
# Next js Blog Boilerplate | ||
|
||
🚀 Next.js Blog Boilerplate is starter code for your blog based on Next.js framework. ⚡️ Made with [Next.js](https://nextjs.org), [TypeScript](https://www.typescriptlang.org), [ESLint](https://eslint.org), [Prettier](https://prettier.io), [PostCSS](https://postcss.org), [Tailwind CSS](https://tailwindcss.com). | ||
|
||
Clone this project and use it to create your own [Next.js](https://nextjs.org) blog. You can check a [Next js blog templates demo](https://creativedesignsguru.com/demo/Nextjs-Blog-Boilerplate/). | ||
|
||
### Features | ||
|
||
Blog feature: | ||
|
||
- 🎈 Syntax Highlighting with Prism.js | ||
- 🤖 SEO metadata and Open Graph tags | ||
- ⚙️ JSON-LD for richer indexing | ||
- 📖 Pagination | ||
- ⬇️ Markdown | ||
- 💯 Maximize lighthouse score | ||
|
||
Developer experience first: | ||
|
||
- 🔥 [Next.js](https://nextjs.org) for Static Site Generator | ||
- 🎨 Integrate with [Tailwind CSS](https://tailwindcss.com) | ||
- 💅 [PostCSS](https://postcss.org) for processing [Tailwind CSS](https://tailwindcss.com) | ||
- 🎉 Type checking [TypeScript](https://www.typescriptlang.org) | ||
- ✏️ Linter with [ESLint](https://eslint.org) | ||
- 🛠 Code Formatter with [Prettier](https://prettier.io) | ||
- 🦊 SEO metadata, [JSON-LD](https://developers.google.com/search/docs/guides/intro-structured-data) and [Open Graph](https://ogp.me/) tags with [Next SEO](https://github.com/garmeeh/next-seo) | ||
|
||
Built-in feature from Next.js: | ||
|
||
- ☕ Minify HTML & CSS with [HTMLMinifier](https://www.npmjs.com/package/html-minifier) | ||
- 💨 Live reload | ||
- ✅ Cache busting | ||
|
||
### Philosophy | ||
|
||
- Minimal code | ||
- SEO-friendly | ||
- 🚀 Production-ready | ||
|
||
### Requirements | ||
|
||
- Node.js and npm | ||
|
||
### Getting started | ||
|
||
Run the following command on your local environment: | ||
|
||
```shell | ||
git clone --depth=1 https://github.com/ixartz/Next-js-Blog-Boilerplate.git my-project-name | ||
cd my-project-name | ||
npm install | ||
``` | ||
|
||
Then, you can run locally in development mode with live reload: | ||
|
||
```shell | ||
npm run dev | ||
``` | ||
|
||
Open http://localhost:8080 with your favorite browser to see your project. | ||
|
||
```shell | ||
. | ||
├── _posts # Your blog posts | ||
├── public # Static files | ||
│ ├── assets | ||
│ │ └── images | ||
│ │ └── posts # Images used in your blog posts | ||
└── src | ||
├── pages # Next.js pages | ||
├── styles # Your blog CSS files | ||
└── templates # Blog templates | ||
``` | ||
|
||
### Customization | ||
|
||
You can easily configure Next js Boilerplate. Please change the following file: | ||
|
||
- `public/apple-touch-icon.png`, `public/favicon.ico`, `public/favicon-16x16.png` and `public/favicon-32x32.png`: your blog favicon, you can generate from https://favicon.io/favicon-converter/ | ||
- `public/assets/images/logo.png`, `public/assets/images/logo-32x32.png`: your blog logo | ||
- `src/styles/main.css`: your blog CSS file using Tailwind CSS | ||
- `src/utils/Config.ts`: configuration file like blog name, url, etc. | ||
- `src/templates/Main.tsx`: blog theme | ||
|
||
### Deploy to production | ||
|
||
You can see the results locally in production mode with: | ||
|
||
```shell | ||
$ npm run build | ||
$ npm run start | ||
``` | ||
|
||
The generated HTML and CSS files are minified (built-in feature from Next js). It will also removed unused CSS from [Tailwind CSS](https://tailwindcss.com). | ||
|
||
You can create an optimized production build with: | ||
|
||
```shell | ||
npm run build-prod | ||
``` | ||
|
||
Now, your blog is ready to be deployed. All generated files are located at `dist` folder, which you can deploy with any hosting service. | ||
|
||
### Deploy to Netlify | ||
|
||
Clone this repository on own GitHub account and deploy to Netlify: | ||
|
||
[![Netlify Deploy button](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/ixartz/Next-js-Blog-Boilerplate) | ||
|
||
### Contributions | ||
|
||
Everyone is welcome to contribute to this project. Feel free to open an issue if you have question or found a bug. | ||
|
||
### License | ||
|
||
Licensed under the MIT License, Copyright © 2020 | ||
|
||
See [LICENSE](LICENSE) for more information. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters