nextjs-chakra-starter-blog — Next.js 博客模板

SHA-256: d0865f02e0a13ce45d7dadd76f389857c6acf0baccea2b94f3ab76871e96d339

2026-10-02T09:19:14.787Z

<img src="https://nextjs-chakra-starter-blog.vercel.app/api/og/cover?heading=nextjs-chakra-starter-blog&template=plain&center=true" />

<div align="center">
  <a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fkingchun1991%2Fnextjs-chakra-starter-blog" target="_blank"><img src="https://vercel.com/button" alt="Deploy with Vercel" /></a> <a href="https://app.netlify.com/start/deploy?repository=https://github.com/kingchun1991/nextjs-chakra-starter-blog" target="_blank"><img src="https://www.netlify.com/img/deploy/button.svg" alt="Deploy to Netlify" /></a> <a href="https://railway.app/new/template/aqmmai?referralCode=9lKVVo" target="_blank"><img src="https://railway.app/button.svg" alt="Deploy on Railway" height="32px" /></a>

<a href="https://stackblitz.com/github/kingchun1991/nextarter-chakra" target="_blank"><img src="https://developer.stackblitz.com/img/open_in_stackblitz.svg" alt="Open in StackBlitz" /></a>

</div>

This is a **Next.js + Chakra UI + TypeScript** starter template packed with modern tooling setup.

## 🚀 Features

-   **Framework**: [Next.js 16](https://nextjs.org/) (App Router)
-   **UI Library**: [Chakra UI v3](https://chakra-ui.com/)
-   **Styling Engine**: Emotion (via Chakra UI) + [next-themes](https://github.com/pacocoursey/next-themes)
-   **Language**: [TypeScript 5](https://www.typescriptlang.org/)
-   **Internationalization**: [next-intl](https://next-intl-docs.vercel.app/) - Optional i18n support (disabled by default, enable with `NEXT_PUBLIC_ENABLE_I18N=true`)
-   **Linting & Formatting**: [Biome](https://biomejs.dev/)
-   **E2E Testing**: [Playwright](https://playwright.dev/)
-   **Build System**: [Turborepo](https://turbo.build/repo)
-   **Icons**: [React Icons](https://react-icons.github.io/react-icons/)
  - `pre-commit`, `pre-push`, `commit-msg`, `prepare-commit-msg` hook configured
- 📱 **PWA-ready** - `next-pwa` configured, enabled by default, just disable it through `next.config.js`
- 🔎 SEO optimization configured - with `next-sitemap`.
  - you'll need to reconfigure or tinker with it to get it right according to your needs, but it's there if you need it.
- 🎨 basic responsive layout configured - don't need it? just remove it 😃
- 🤖 **Automatic Dependency Update** with [Renovate](https://renovatebot.com/)
- 🗒️ **MDX Blog** with enhanced features
  - 📊 **Table Support** - Beautiful, responsive tables with Chakra UI v3 styling
    - GitHub Flavored Markdown table syntax support via `remark-gfm`
    - Automatic column alignment (left, right, center)
    - Responsive design with horizontal scrolling on mobile
    - Dark/light mode support with hover effects
    - Enhanced table component for JSON data
  - 🖼️ Automatic Open Graph Cover generation
  - 👤 Author information and avatars
  - ⏱️ Reading time calculation

[![CodeFactor](https://www.codefactor.io/repository/github/kingchun1991/nextjs-chakra-starter-blog/badge)](https://www.codefactor.io/repository/github/kingchun1991/nextjs-chakra-starter-blog)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=kingchun1991_nextjs-chakra-starter-blog&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=kingchun1991_nextjs-chakra-starter-blog)[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=kingchun1991_nextjs-chakra-starter-blog&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=kingchun1991_nextjs-chakra-starter-blog) [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=kingchun1991_nextjs-chakra-starter-blog&metric=bugs)](https://sonarcloud.io/dashboard?id=kingchun1991_nextjs-chakra-starter-blog) [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=kingchun1991_nextjs-chakra-starter-blog&metric=code_smells)](https://sonarcloud.io/dashboard?id=kingchun1991_nextjs-chakra-starter-blog) [![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=kingchun1991_nextjs-chakra-starter-blog&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=sozonome_nextarter-chakra)

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fkingchun1991%2Fnextjs-chakra-starter-blog&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false)](https://hits.seeyoufarm.com)


## 🏗 System Architecture

This project uses a **Split-Layer** architecture to separate Next.js routing concerns from React UI logic.

```mermaid
graph TD
    subgraph "Routing Layer (src/app)"
        L[layout.tsx] --> Providers
        P[page.ts] --> Logic
    end

    subgraph "Logic Layer (src/lib)"
        Providers --> Layout[Layout Component]
        Layout --> Header
        Layout --> Footer
        Logic --> HomePage[Page Component]
    end

    subgraph "UI Layer (src/components)"
        HomePage --> Components
        Header --> Components
        Footer --> Components
    end
```

## 📂 Repository Structure

The code is organized to keep business logic and routing separate:

```bash
src/
├── app/            # Next.js App Router (Entry points)
│   ├── layout.tsx  # Global RootLayout & Providers
│   └── page.ts     # Re-exports Home from lib/pages
├── components/     # Shared UI components
│   └── ui/         # Primitives (Buttons, Inputs, etc.)
└── lib/            # Application Business Logic
    ├── layout/     # Shell components (Header, Footer)
    ├── pages/      # Page implementations (Home, etc.)
    └── styles/     # Theme configuration
```

## 🛠 Getting Started

### 1. Get the Code

Click the **Use this template** button on this repository, or clone it directly:

```bash
git clone https://github.com/kingchun1991/nextjs-chakra-starter-blog.git <YOUR_APP_NAME>
cd <YOUR_APP_NAME>
```

Alternatively, use `degit` to clone without git history:

```bash
npx degit kingchun1991/nextjs-chakra-starter-blog <YOUR_APP_NAME>
cd <YOUR_APP_NAME>
```

> **Prerequisites**: Node.js v24+ and [pnpm](https://pnpm.io/) are required.
> Install pnpm with: `npm install -g pnpm`

### 2. Install Dependencies

```bash
pnpm install
```

### 3. Run Development Server

```bash
pnpm dev
```

Open [http://localhost:3000](http://localhost:3000) to view it in the browser.

### 4. Build for Production

```bash
pnpm build
```

### 5. Run Tests

```bash
pnpm test:e2e
```

## 🧹 Code Quality

We use **Biome** for fast formatter and linter.

```bash
# Check code issues
pnpm biome:check

# Fix issues automatically
pnpm biome:fix
```