Modular package structure: four independent packages—core, ai, notify, and cli—that can be combined as needed
AstroBlog
astro-minimax — Astro Blog Template
By souloss
astro-minimax is a minimal Astro-based blog theme with a modular package structure, supporting multi-language content, full-text search, dynamic OG images, visualization components such as Mermaid, and optional AI chat and notification features.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-02View source
What stands out
A quick read of the recorded project description.
Content enhancement components: Mermaid diagrams, Markmap mind maps, Rough.js hand-drawn graphics, Excalidraw embedding, and Asciinema terminal recordings
Optional AI chat: multi-provider failover, RAG retrieval, streaming chat, read-along chat, and privacy protection
Search and interaction: Pagefind or Algolia DocSearch full-text search, Waline comments, and Umami analytics
Multi-language and SEO: Chinese and English support, dynamic OG image generation, categories, tags, series, and archives
CLI toolchain: blog creation, article processing, AI evaluation, profiling, and fact registry construction
Template Details
astro-minimax is an Astro blog theme built around a minimal style, with code split into modules: @astro-minimax/core provides layouts, components, styles, route injection, and visualization components; @astro-minimax/ai handles AI chat and RAG retrieval; @astro-minimax/notify handles multi-channel notifications; and @astro-minimax/cli provides command-line tools for blog creation, article processing, and quality evaluation. The example blog is located in apps/blog and can serve as a development preview site.
At the content level, it supports type-safe Markdown/MDX, includes categories, tags, series, and archives, and offers light/dark theme switching, responsive layout, and accessibility support. Search can use either Pagefind or Algolia DocSearch, comments use Waline, analytics integrates with Umami, and dynamic OG image generation is supported. Multi-language support currently covers Chinese and English.
For content enhancement, it can embed Mermaid diagrams, Markmap mind maps, Rough.js hand-drawn graphics, Excalidraw whiteboards, and Asciinema terminal recordings. AI-related features are optional modules, including multi-provider failover, streaming chat, read-along chat, source layering to prevent hallucinations, and refusal of sensitive information queries, along with CLI commands for golden test set evaluation, author profiling, and fact registry construction.
There are three ways to use it: CLI creation, GitHub Template, or integration as NPM packages. The README notes that the CLI method is currently not yet mature, but the generated directory skeleton is clear and does not require managing related dependencies. Deployment targets include Cloudflare Pages, Vercel, Netlify, and Docker. The project is a secondary development based on AstroPaper and uses the MIT license; the free scope is limited to this version of the code, while third-party assets such as demo images, fonts, and icons, as well as external services such as domains, hosting, and AI, require separate verification of licensing or costs.
AstroBlog
Is it right for your project?
Use Cases
- Building a content-focused personal technical blog or writing site
- Scenarios that require embedding flowcharts, mind maps, hand-drawn graphics, or terminal recordings in articles
- Sites that want to add AI Q&A, article read-along, and source citation capabilities to a blog
- Blogs that need bilingual Chinese-English content, full-text search, and dynamic social sharing images
- Developers integrating the theme into an existing Astro project via CLI or NPM packages
Suitable For
- Developers familiar with Astro and TypeScript who want to combine features by package
- Blog authors who prefer minimal typography and article-focused content
- Technical sites that need multi-language support, full-text search, and visual content enhancement
- Users willing to configure external services such as AI, comments, and analytics themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Can be created with npx @astro-minimax/cli init, or by using pnpm create astro with the souloss/astro-minimax template, or integrated as NPM packages; the README notes that the CLI method is currently not yet mature.
- 2
AI chat, Waline comments, Umami analytics, Algolia DocSearch, and notification channels are optional external services that require preparing accounts and configuration yourself.
- 3
The code uses the MIT license; when distributing, the copyright notice and license notice must be retained; third-party assets such as demo images, fonts, and icons must be checked against their respective licenses.
- 4
Deployment targets include Cloudflare Pages, Vercel, Netlify, and Docker; refer to the deployment guide in the repository for specific configuration.
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is limited to this version of the code and does not mean that external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
- The CLI creation method is currently not yet mature and is an early-stage tool that may be unstable or incomplete; for stability, it is recommended to use the GitHub Template or NPM package integration method instead.
- AI chat is an optional module and requires additionally installing the @astro-minimax/ai package; using AI features requires configuring an external AI service (such as Cloudflare Workers AI) and the corresponding account or API key yourself.
- AI features depend on external services such as the Vercel AI SDK and Cloudflare Workers AI; you must prepare accounts and keys yourself and bear possible usage costs.
- Notification features depend on external services such as Telegram, Resend email, or Webhooks; you must register accounts and configure credentials yourself, which may incur third-party costs.
- Full-text search can use Pagefind or Algolia DocSearch; choosing Algolia DocSearch requires applying for and relying on its externally hosted service.
- The comment system uses Waline; you must deploy the Waline server yourself or use its hosted service, involving additional configuration and possible costs.
- Access analytics depends on Umami; you must deploy it yourself or use its cloud service, involving additional accounts and configuration.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
> 当前暂不够成熟，但使用 cli 创建的博客目录骨架最清晰简单，无需管理相关依赖，可享受其它包持续迭代的红利
Original README
pnpm add @astro-minimax/ai # 可选，AI 聊天
Original README
| **AI** | [Vercel AI SDK v6](https://sdk.vercel.ai/) + Cloudflare Workers AI |
Original README
| **通知** | Telegram / Email (Resend) / Webhook |
Original README
| **搜索** | [Pagefind](https://pagefind.app/) / [Algolia DocSearch](https://docsearch.algolia.com/) |
Original README
| **评论** | [Waline](https://waline.js.org/) |
Original README
https://github.com/souloss/astro-minimax/blob/main/LICENSEhttps://github.com/souloss/astro-minimax/blob/main/README.md| **统计** | [Umami](https://umami.is/) |
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-04. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 83 / 100
- Technologies
- Astro
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-05-14
- Screenshot last checked
- 2026-10-04
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-05
Inspect the recorded source material
SHA-256: cb540b3925b9d0337b42efa831d38869cb6aa28a567c9a6012c8f15a06933552
2026-10-04T21:25:30.341Z
Source file / repository# astro-minimax
[**English**](./README.en.md) | 简体中文
> **astro-minima-X** — 极简（Minima）为底座，X 代表无限扩展。
astro-minimax 是一个极简、现代化、模块化的 Astro 博客主题。以极简风格为核心，同时提供丰富的可视化组件和功能扩展。支持多语言、AI 聊天、多种搜索方案、Mermaid 图表、Markmap 思维导图等。
## 设计哲学
- **极简优先** — 简洁的设计，内容为核心
- **模块化可插拔** — 四个独立包，按需组合
- **现代化** — Astro v6、Tailwind v4、TypeScript 严格模式、AI SDK v6
- **内容与系统分离** — 通过 CLI / NPM 包 / GitHub Template 灵活集成
## 功能特性
### 核心功能
- [x] 类型安全的 Markdown / MDX
- [x] 极致性能（Lighthouse 90+）
- [x] 无障碍支持
- [x] 响应式设计
- [x] SEO 友好
- [x] 明暗主题切换（View Transitions 动画）
- [x] 全文搜索（Pagefind 或 Algolia DocSearch）
- [x] 动态 OG 图片生成
- [x] 多语言支持（中文/英文）
- [x] 分类、标签、系列、归档
### 内容增强
- [x] 📊 **Mermaid 图表** — 流程图、时序图等
- [x] 🧠 **Markmap 思维导图** — 交互式思维导图
- [x] ✏️ **Rough.js 手绘图形** — 手绘风格 SVG
- [x] 🖌️ **Excalidraw 嵌入** — 白板风格图表
- [x] 📺 **Asciinema 终端回放** — 嵌入终端录制
### 互动功能
- [x] 🤖 **AI 聊天** — 多 Provider 自动故障转移、RAG 增强、流式对话、来源分层防幻觉
- [x] 📖 **边读边聊** — 文章页 AI 陪读，自动感知文章上下文
- [x] 🔒 **AI 隐私保护** — 自动拒绝敏感个人信息查询
- [x] 🧪 **AI 质量评估** — 黄金测试集自动化评估
- [x] 💬 **Waline 评论** — 互动评论系统
- [x] 🔔 **多渠道通知** — Telegram / Email / Webhook
- [x] 📊 **Umami 统计** — 隐私友好的访问分析
- [x] ☕ **赞助打赏** — 支持多种支付方式
## 三种使用方式
### 方式一：CLI 创建（推荐）
```bash
npx @astro-minimax/cli init my-blog
cd my-blog && pnpm install && pnpm run dev
```
> 当前暂不够成熟，但使用 cli 创建的博客目录骨架最清晰简单，无需管理相关依赖，可享受其它包持续迭代的红利
### 方式二：GitHub Template
```bash
pnpm create astro@latest --template souloss/astro-minimax
cd my-blog && pnpm install && pnpm run dev
```
### 方式三：NPM 包集成
```bash
pnpm add @astro-minimax/core # 核心主题（含可视化组件）
pnpm add @astro-minimax/ai # 可选，AI 聊天
pnpm add -D @astro-minimax/cli # 推荐，CLI 工具
```
详见 [快速开始指南](apps/blog/src/data/blog/zh/getting-started.md)。
## 项目结构
```bash
astro-minimax/
├── packages/
│ ├── core/ # @astro-minimax/core — 核心主题（布局、组件、样式、路由、插件、可视化）
│ ├── ai/ # @astro-minimax/ai — AI 集成（RAG、多 Provider、流式对话）
│ ├── notify/ # @astro-minimax/notify — 多渠道通知
│ └── cli/ # @astro-minimax/cli — CLI 工具链（创建、处理、评估）
└── apps/
└── blog/ # 示例博客 / 开发预览站
```
## 技术栈
| 类别 | 技术 |
| ------------ | --------------------------------------------------------------------------------------- |
| **主框架** | [Astro v6](https://astro.build/) |
| **样式** | [TailwindCSS v4](https://tailwindcss.com/) |
| **搜索** | [Pagefind](https://pagefind.app/) / [Algolia DocSearch](https://docsearch.algolia.com/) |
| **评论** | [Waline](https://waline.js.org/) |
| **图表** | [Mermaid](https://mermaid.js.org/) |
| **思维导图** | [Markmap](https://markmap.js.org/) |
| **AI** | [Vercel AI SDK v6](https://sdk.vercel.ai/) + Cloudflare Workers AI |
| **通知** | Telegram / Email (Resend) / Webhook |
| **统计** | [Umami](https://umami.is/) |
| **部署** | Cloudflare Pages / Vercel / Netlify / Docker |
## CLI 命令
通过 `@astro-minimax/cli` 提供完整的命令行工具：
```bash
# 博客管理
astro-minimax init my-blog # 创建新博客
astro-minimax post new "标题" # 创建新文章
astro-minimax post list # 列出所有文章
# AI 功能（统一入口）
astro-minimax ai process # AI 处理文章（摘要+SEO）
astro-minimax ai eval # AI 对话质量评估
astro-minimax ai profile build # 构建作者画像
astro-minimax ai facts build # 构建事实注册表
astro-minimax ai extensions status # 查看扩展状态
# 数据管理
astro-minimax data status # 查看数据文件状态
astro-minimax data clear # 清理生成的缓存
```
在博客目录中也可以使用 `pnpm run` 快捷方式：`pnpm run ai:process`、`pnpm run ai:profile:build` 等。
## 包说明
| 包 | 版本 | 说明 |
| ------------------------------------------- | ----- | ----------------------------------------------------------- |
| [`@astro-minimax/core`](packages/core/) | 0.9.3 | 核心主题：布局、组件、样式、路由注入、虚拟模块、可视化 |
| [`@astro-minimax/ai`](packages/ai/) | 0.9.3 | AI 集成：多 Provider 故障转移、RAG 检索、来源分层、隐私保护 |
| [`@astro-minimax/notify`](packages/notify/) | 0.9.3 | 通知系统：Telegram Bot、Email (Resend)、Webhook |
| [`@astro-minimax/cli`](packages/cli/) | 0.9.3 | CLI 工具：博客创建、AI 处理、画像构建、质量评估 |
## 文档
- [快速开始](apps/blog/src/data/blog/zh/getting-started.md)
- [功能特性](apps/blog/src/data/blog/zh/feature-overview.md)
- [主题配置](apps/blog/src/data/blog/zh/how-to-configure-astro-minimax-theme.md)
- [添加文章](apps/blog/src/data/blog/zh/adding-new-post.md)
- [部署指南](apps/blog/src/data/blog/zh/deployment-guide.md)
- [通知系统](apps/blog/src/data/blog/zh/notification-guide.md)
- [自定义配色](apps/blog/src/data/blog/zh/how-to-configure-astro-minimax-theme.md)
- [动态 OG 图片](apps/blog/src/data/blog/zh/dynamic-og-images.md)
- [v0.9.3 发布说明](apps/blog/src/data/blog/zh/_releases/astro-minimax-0.9.3.md)
## 致谢
基于 [AstroPaper](https://github.com/satnaing/astro-paper) 二次开发。
## 许可证
MIT License - Copyright © 2026
---
由 [Souloss](https://souloss.cn) 用心打造。
Explore similar templates
Compare previews and descriptions within the same stack and category.
astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog
astro-paper
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
Astro · Blog
fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog
Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog
astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio
astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio