Next.js Minimal Blog Template

This is a lightweight, minimalistic blog template built with Next.js 15, MDX, Tailwind CSS, and shadcn/ui.

Tech Stack

• Framework - Next.js (v15)
• Language - TypeScript
• Styling - Tailwind CSS (v4)
• UI Components - shadcn/ui
• Static Content Management - MDX
• Syntax Highlight - Rehype Pretty Code + Shiki
• Deployment - Vercel
• Code Linting - ESLint (v9, Flat Config)
• Code Formatting - Prettier

Project Philosophy

This project follows a minimalist approach to building a Next.js-based MDX blog.

• Official-First: Prioritize using official Next.js libraries to ensure stability and maintainability.
• Minimal & Fast: Keep the project lightweight and fast, avoiding unnecessary dependencies.

Running Locally

Follow these steps to set up and run the project on your local machine.

Clone the repository

Note

This repository is set as a Public Template, so you can use it as a template by clicking "Use this template"!

git clone git@github.com:cakegaly/next-minimal-blog.git
cd next-minimal-blog

Install dependencies & Set up environment variables

pnpm i
cp .env.example .env.local

Please set http://localhost:8888 to NEXT_PUBLIC_APP_URL.

Build the project

pnpm build

Start the development server

pnpm dev

Open in your browser

Visit http://localhost:8888 to see the site in action 🎅

Deployment

This project is automatically deployed on Vercel.

License

This project is licensed under the MIT License.

Thanks

This project was inspired by and heavily influenced by the following open-source projects:

• shadcn/ui – The best UI library for building modern, accessible design systems. This incredible project served as the foundation for the design of this template.
• shadcn/taxonomy – A well-structured and minimal approach to building content-driven applications with Next.js and shadcn/ui.
• astro-nomy – A beautifully designed Astro blog template that influenced the content and design philosophy of this project.

---

If you find this project useful, feel free to give it a ⭐ on GitHub!