rsnext/examples/blog-starter-typescript
Michael McQuade ded6e24b3d
Use autoprefixer instead of postcss-preset-env (#21215)
I realized while looking over this that the `autoprefixer` plugin isn't being used by postcss because it's not included in the `postcss.config.js`. Additionally, since `postcss-preset-env` doesn't support PostCSS 8 yet, and it includes PostCSS 7 as a dependency, I've removed that package. 

There is an open issue to add PostCSS 8 support to `postcss-preset-env` [here](https://github.com/csstools/postcss-preset-env/issues/191). @kripod's comments on my other PR #20956 are what prompted me to check this out. 

On a side note, it looks like all the CMS examples use Tailwind CSS v1 still, so that's something someone (possibly myself) could tackle later.
2021-01-22 06:13:33 +00:00
..
@types [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
_posts [Fix] common misspelling errors (#15288) 2020-07-19 04:38:20 +00:00
components Update to Tailwind CSS 2.0 in blog-starter-typescript example (#20664) 2021-01-01 18:45:55 +00:00
lib [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
pages chore: remove-redundant-example-react-import (#13907) 2020-06-08 21:31:56 -04:00
public [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
styles [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
types [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
.gitignore Added .gitignore to examples that are deployed to vercel (#15127) 2020-07-16 10:52:23 -04:00
next-env.d.ts [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
package.json Use autoprefixer instead of postcss-preset-env (#21215) 2021-01-22 06:13:33 +00:00
postcss.config.js Use autoprefixer instead of postcss-preset-env (#21215) 2021-01-22 06:13:33 +00:00
README.md Fix deploy buttons URLs (#20834) 2021-01-07 01:40:29 +00:00
tailwind.config.js [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00
tsconfig.json [Examples] Added blog-starter-typescript (#12981) 2020-05-23 20:34:35 +02:00

A statically generated blog example using Next.js, Markdown, and TypeScript

This is the existing blog-starter plus TypeScript.

This example showcases Next.js's Static Generation feature using Markdown files as the data source.

The blog posts are stored in /_posts as Markdown files with front matter support. Adding a new Markdown file in there will create a new blog post.

To create the blog posts we use remark and remark-html to convert the Markdown files into an HTML string, and then send it down as a prop to the page. The metadata of every post is handled by gray-matter and also sent in props to the page.

How to use

Deploy your own

Deploy the example using Vercel:

Deploy with Vercel

Execute create-next-app with npm or Yarn to bootstrap the example:

npx create-next-app --example blog-starter-typescript blog-starter-typescript-app
# or
yarn create next-app --example blog-starter-typescript blog-starter-typescript-app

Your blog should be up and running on http://localhost:3000! If it doesn't work, post on GitHub discussions.

Deploy it to the cloud with Vercel (Documentation).

Notes

This blog-starter-typescript uses Tailwind CSS. To control the generated stylesheet's filesize, this example uses Tailwind CSS' v2.0 purge option to remove unused CSS.

Tailwind CSS v2.0 no longer supports Node.js 8 or 10. To build your CSS you'll need to ensure you are running Node.js 12.13.0 or higher in both your local and CI environments.