next-minimal-blog

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

next-minimal-blog

★ 14 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Next.js Minimal Blog Template

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

![Demo ScreenShot](https://raw.githubusercontent.com/cakegaly/next-minimal-blog/main/public/images/demo/screenshot.png)

## Tech Stack

- Framework - [Next.js](https://nextjs.org/15) (v15)
- Language - [TypeScript](https://www.typescriptlang.org)
- Styling - [Tailwind CSS](https://tailwindcss.com) (v4)
- UI Components - [shadcn/ui](https://ui.shadcn.com)
- Static Content Management - [MDX](https://mdxjs.com)
- Syntax Highlight - [Rehype Pretty Code](https://rehype-pretty.pages.dev/) + [Shiki](https://github.com/shikijs/shiki)
- Deployment - [Vercel](https://vercel.com)
- Code Linting - [ESLint](https://eslint.org) (v9, Flat Config)
- Code Formatting - [Prettier](https://prettier.io)

## 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"!

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

### Install dependencies & Set up environment variables

```sh
pnpm i
cp .env.example .env.local
```

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

### Build the project

```sh
pnpm build
```

### Start the development server

```sh
pnpm dev
```

### Open in your browser

Visit **[http://localhost:8888](http://localhost:8888)** to see the site in action 🎅

## Deployment

This project is automatically deployed on **[Vercel](https://next-minimal-blog-delta.vercel.app/)**.

## 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](https://github.com/shadcn-ui/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](https://github.com/shadcn-ui/taxonomy) – A well-structured and minimal approach to building content-driven applications with Next.js and shadcn/ui.
- [astro-nomy](https://github.com/mickasmt/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!

next-minimal-blog

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README