Data

Tools

Indexes

Applications

Experiments

Open Source Science

suzublog

A minimalist and fast Next.js blog template, one-click deploy, writing in Markdown. 基于 Next.js 的博客模板，一键启动，简易配置，使用 Markdown 撰写你的文章。

https://github.com/zl-asica/suzublog

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (14.5%) to scientific vocabulary

Keywords

blog minimalist nextjs react static-site-generator suzu tailwindcss typescript
Last synced: 6 months ago · JSON representation ·

Repository

A minimalist and fast Next.js blog template, one-click deploy, writing in Markdown. 基于 Next.js 的博客模板，一键启动，简易配置，使用 Markdown 撰写你的文章。

Basic Info
  • Host: GitHub
  • Owner: ZL-Asica
  • License: agpl-3.0
  • Language: TypeScript
  • Default Branch: main
  • Homepage: https://suzu.zla.app
  • Size: 5.15 MB
Statistics
  • Stars: 26
  • Watchers: 1
  • Forks: 4
  • Open Issues: 12
  • Releases: 25
Topics
blog minimalist nextjs react static-site-generator suzu tailwindcss typescript
Created over 1 year ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing Funding License Code of conduct Citation

README.md

SuzuBlog 🎐

English | 中文 | 日本語

Suzu (鈴) means "bell" in Japanese — a minimalist Next.js + Markdown blog template.

🚀 Live Demo | 📚 Documentation

If you enjoy using it, please consider giving it a star! ⭐ I hope you find it as enjoyable as I do!

GitHub License Latest Release

Node.js pnpm Version | Next.js Tailwind CSS | Vercel Eslint Prettier

✨ Features

  • 🚀 Next.js Powered – Supports ISR & SSG for lightning-fast performance.
  • 📄 Markdown Support – Code highlighting with copy button, LaTeX rendering, optimized images, and elegant styling.
  • 🔍 SEO Ready – Auto-generates sitemap, Open Graph, Twitter Cards, and more.
  • 🌍 Multi-Language – Supports English, Chinese, Japanese, and more via config.yml.
  • 📺 Anime List – Fetch & display anime info from AniList API.
  • 🌓 Dark Mode – Adapts to system preferences seamlessly.
  • 📢 RSS Feed – Auto-generated RSS for easy content distribution.
  • ♿ Accessibility First – Semantic HTML, ARIA support, WCAG-compliant colors.
  • ⚛️ LLM Support – Auto-generated llms.txt and llms-full.txt files for LLMs like ChatGPT, Claude, and more.

🚀 Get Started

Ready to launch your own Suzu Blog? Just click the button below to deploy instantly with Vercel:

Deploy with Vercel

Need help with setup, customization, or deployment? Check out the full documentation:

📖 Suzu Blog Docs

🏗️ Project Structure

plaintext . ├── config.yml # Global configuration file ├── posts # Markdown posts directory │ └── _pages # Special pages (About/Friends) ├── public # Static assets directory │ └── images # Image resources ├── src # Project source code │ ├── app # Next.js App Router │ ├── components # Reusable components │ ├── services # Logic for content parsing, configuration, etc. │ ├── schemas # Zod schemas │ └── types # Global type definitions ├── package.json # Project dependencies and scripts └── pnpm-lock.yaml # pnpm dependency lock file

❤️ About Suzu

After years of frustration with the maintenance, security risks, and performance issues of other frameworks, I decided to create Suzu Blog using Next.js. It is simple, efficient, and highly customizable, designed for anyone looking to build a modern blog quickly.

🔗 Community Support

Contribute: Contributions are welcome! Please refer to the Contribution Guide.

📜 License

This project is licensed under the AGPL-3.0 License. See the LICENSE file for details.

Owner

  • Name: Elara Liu
  • Login: ZL-Asica
  • Kind: user
  • Location: Evanston, IL
  • Company: Northwestern University

CS Master@NU | HCI Researcher

Citation (CITATION.cff) 

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: SuzuBlog
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Zhuoran
    family-names: Liu
    orcid: 'https://orcid.org/0009-0008-7221-2324'
    affiliation: Northwestern University
identifiers:
  - type: doi
    value: 10.5281/zenodo.15377307
repository-code: 'https://github.com/ZL-Asica/SuzuBlog'
url: 'https://suzu.zla.app/en/'
abstract: >-
  SuzuBlog, named after the Japanese word (suzu, meaning
  "bell"), is a minimalist, high-performance blog system
  inspired by Japanese aesthetics, built with Next.js. The
  project emphasizes delivering a calm, visually clean, and
  efficient reading experience with lightweight content
  management powered by Markdown and YAML.
keywords:
  - Blog
  - Frontend
  - Next.js
license: AGPL-3.0

GitHub Events

Total
  • Create event: 98
  • Release event: 31
  • Issues event: 77
  • Watch event: 28
  • Delete event: 65
  • Issue comment event: 182
  • Push event: 446
  • Pull request review comment event: 21
  • Pull request review event: 40
  • Pull request event: 183
  • Fork event: 6
Last Year
  • Create event: 98
  • Release event: 31
  • Issues event: 77
  • Watch event: 28
  • Delete event: 65
  • Issue comment event: 182
  • Push event: 446
  • Pull request review comment event: 21
  • Pull request review event: 40
  • Pull request event: 183
  • Fork event: 6

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 47
  • Total pull requests: 180
  • Average time to close issues: 11 days
  • Average time to close pull requests: 3 days
  • Total issue authors: 4
  • Total pull request authors: 4
  • Average comments per issue: 0.36
  • Average comments per pull request: 1.51
  • Merged pull requests: 69
  • Bot issues: 1
  • Bot pull requests: 109
Past Year
  • Issues: 47
  • Pull requests: 180
  • Average time to close issues: 11 days
  • Average time to close pull requests: 3 days
  • Issue authors: 4
  • Pull request authors: 4
  • Average comments per issue: 0.36
  • Average comments per pull request: 1.51
  • Merged pull requests: 69
  • Bot issues: 1
  • Bot pull requests: 109
View more stats
Top Authors
Issue Authors
  • ZL-Asica (42)
  • Kemeow815 (2)
  • houliabc (2)
  • dependabot[bot] (1)
Pull Request Authors
  • dependabot[bot] (117)
  • ZL-Asica (74)
  • fossabot (2)
  • Natsusomekeishi (2)
  • hjx754242756 (1)
Top Labels
Issue Labels
enhancement (26) bug (20) posts (1) types (1) main (1) styles (1) size/XL (1) services (1) dependencies (1) javascript (1)
Pull Request Labels
dependencies (118) size/XS (92) enhancement (57) main (50) common-components (49) size/L (41) posts (33) services (33) types (31) bug (31) styles (28) size/M (26) javascript (21) content (16) service (7) size/XL (6) size/S (6) design (6) layout (5) lib (2)

Dependencies

.github/workflows/mind-your-language.yml actions
  • actions/checkout v2 composite
  • tailaiw/mind-your-language-action v1.0.3 composite
package.json npm
  • @tailwindcss/typography ^0.5.15 development
  • @types/node ^20 development
  • @types/react ^18 development
  • @types/react-dom ^18 development
  • eslint ^8 development
  • eslint-config-next 14.2.15 development
  • eslint-config-prettier ^9.1.0 development
  • husky ^9.1.6 development
  • lint-staged ^15.2.10 development
  • postcss ^8 development
  • prettier ^3.3.3 development
  • prettier-plugin-tailwindcss ^0.6.8 development
  • tailwindcss ^3.4.1 development
  • typescript ^5.6.0 development
  • gray-matter ^4.0.3
  • next 14.2.15
  • react ^18
  • react-dom ^18
  • react-icons ^5.3.0
  • remark ^15.0.1
  • remark-html ^16.0.1
.github/workflows/label-pr-based-on-paths.yml actions
  • actions/checkout v3 composite
  • actions/github-script v7 composite
.github/workflows/label-pr-size.yml actions
  • actions/github-script v7 composite
  • pascalgn/size-label-action v0.5.4 composite
pnpm-lock.yaml npm
  • cliui@8.0.2
  • code-frame@7.26.2
  • config-array@0.18.0
  • core@0.19.1
  • core@0.7.0
  • counter@0.1.3
  • env@15.0.3
  • eslint-plugin-next@15.0.3
  • eslint-plugin@8.13.0
  • eslint-utils@4.4.1
  • eslintrc@3.1.0
  • estree@1.0.6
  • fs.scandir@2.1.5
  • fs.stat@2.0.5
  • fs.walk@1.2.8
  • gen-mapping@0.3.5
  • helper-validator-identifier@7.25.9
  • helpers@0.5.13
  • js@9.14.0
  • json-schema@7.0.15
  • json5@0.0.29
  • module-importer@1.0.1
  • node@0.16.6
  • node@22.9.0
  • normalize-package-data@2.4.4
  • object-schema@2.1.4
  • parseargs@0.11.0
  • parser@8.13.0
  • plugin-kit@0.2.2
  • prettier-config@1.0.7
  • prop-types@15.7.13
  • quick-lru@5.2.0
  • react@18.3.12
  • regexpp@4.12.1
  • resolve-uri@3.1.2
  • retry@0.3.1
  • retry@0.4.1
  • runtime@1.3.1
  • scc@1.1.0
  • scope-manager@8.13.0
  • set-array@1.2.1
  • sharp-darwin-arm64@0.33.5
  • sharp-darwin-x64@0.33.5
  • sharp-libvips-darwin-arm64@1.0.4
  • sharp-libvips-darwin-x64@1.0.4
  • sharp-libvips-linux-arm64@1.0.4
  • sharp-libvips-linux-arm@1.0.5
  • sharp-libvips-linux-s390x@1.0.4
  • sharp-libvips-linux-x64@1.0.4
  • sharp-libvips-linuxmusl-arm64@1.0.4
  • sharp-libvips-linuxmusl-x64@1.0.4
  • sharp-linux-arm64@0.33.5
  • sharp-linux-arm@0.33.5
  • sharp-linux-s390x@0.33.5
  • sharp-linux-x64@0.33.5
  • sharp-linuxmusl-arm64@0.33.5
  • sharp-linuxmusl-x64@0.33.5
  • sharp-wasm32@0.33.5
  • sharp-win32-ia32@0.33.5
  • sharp-win32-x64@0.33.5
  • sourcemap-codec@1.5.0
  • swc-darwin-arm64@15.0.3
  • swc-darwin-x64@15.0.3
  • swc-linux-arm64-gnu@15.0.3
  • swc-linux-arm64-musl@15.0.3
  • swc-linux-x64-gnu@15.0.3
  • swc-linux-x64-musl@15.0.3
  • swc-win32-arm64-msvc@15.0.3
  • swc-win32-x64-msvc@15.0.3
  • trace-mapping@0.3.25
  • type-utils@8.13.0
  • types@8.13.0
  • typescript-estree@8.13.0
  • typography@0.5.15
  • utils@8.13.0
  • visitor-keys@8.13.0
.github/workflows/sync-suzublog.yml actions
  • actions/checkout v4 composite