aec401f74a
Bumps [minimist](https://github.com/substack/minimist) from 1.2.5 to 1.2.6. - [Release notes](https://github.com/substack/minimist/releases) - [Commits](https://github.com/substack/minimist/compare/1.2.5...1.2.6) --- updated-dependencies: - dependency-name: minimist dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>
Next.js + Tailwind CSS + MDX Starter Template
A starter template for Next.JS with Tailwind and MDX. Intentionally limited feature-set to keep things simple. (If you want a more comprenhensive starter template check out https://github.com/timlrx/tailwind-nextjs-starter-blog).
Includes instructions on how to rapidly customize the site.
Preview online at https://nextjs-tailwind-mdx-tau.vercel.app
Features
Pre-configured with the following;
- Tailwind for easy styling. Booted off NextJS default tailwindcss example (https://github.com/vercel/next.js/tree/canary/packages/create-next-app)
- Markdown / MDX rendering support. All markdown/MDX in
/content/gets auto-rendered into the site. - Configurable e.g. site title etc (secret config in environment variables). See
Configurationbelow. - Simple theming via
components/Layout.js. Used to provide a standard them for all pages. Customizable NavBar and Footer with configurable nav links. - Analytics: Google analytics support following https://github.com/vercel/next.js/tree/canary/examples/with-google-analytics
- SEO: basic SEO out of the box (via https://github.com/garmeeh/next-seo)
How to use
Execute create-next-app with npm or Yarn to bootstrap the example:
npx create-next-app --example https://github.com/datopian/portal.js/tree/main/examples/nextjs-tailwind-mdx
# or
yarn create-next-app --example https://github.com/datopian/portal.js/tree/main/examples/nextjs-tailwind-mdx
Then run the app:
cd myapp
npm run dev
Configuration
See config directory:
config/siteConfig.jsfor site wide configuration especially for general theme (e.g. title) and SEOconfig/navLinks.jsfor configuration of navigation links
How to customize the content directory location?
Open up pages/[...slug].js and change the CONTENT_PATH variable.
Theming
We suggest the following:
- Replace the favicon in
public/favicon.icoor use the svg favicon ... - Add a logo: add image to
publice.g. then opencomponents/layout.jsand replace footer logo link
Tweaking the theme in general: open up components/Layout.js and tweak away.