读取

01mvp-blog-starter是一个Cloudflare-native的个人出版系统,拥有由Git管理的文件系统.

它的船体表面有两个含量:

• /blog通过发布后端为帖子、管理员写作、评论、RSS、OpenAPI出版、进口、出口和备份提供动力。
• /docs由Fumadocs和GitHub Markdown/MDX为产品docs、开发者docs、API指南和模板注释提供动力。

□ 堆叠

• TanStack Start + TanStack 路由器
• 反应19+反应编译器
• 尾风CSS+阴影/井
• Git管理文件的Fumadocs
• 英文和中文UI信息的paraglide.js
• 云浮工人通过@cloudflare/vite-plugin
• Cloudflare D1 用于文章、评论、设置、用户、会话和 API 令牌
• Cloudflare R2用于资产、进出口和备份
• Cloudflare KV用于缓存元数据和短寿命记录

□ 部署到云浮

使用上方的 Cloudflare 按钮来创建和部署您从公共 GitHub 寄存器库复制的文本 。

按钮适用于工人应用程序. 这个寄存器是一个 pnpm monorepo,所以根包脚本是部署的入口:

这个寄存器的"apps/web/wrangler".

01mvp-blog-starter

中文 README

01mvp-blog-starter is a Cloudflare-native personal publishing system with a Git-managed documentation system.

It ships with two content surfaces:

• /blog is powered by the publishing backend for posts, admin writing, comments, RSS, OpenAPI publishing, imports, exports, and backups.
• /docs is powered by Fumadocs and GitHub Markdown/MDX for product docs, developer docs, API guides, and template notes.

Stack

• TanStack Start + TanStack Router
• React 19 + React Compiler
• Tailwind CSS + shadcn/ui
• Fumadocs for Git-managed documentation
• Paraglide.js for English and Chinese UI messages
• Cloudflare Workers via @cloudflare/vite-plugin
• Cloudflare D1 for posts, comments, settings, users, sessions, and API tokens
• Cloudflare R2 for assets, imports, exports, and backups
• Cloudflare KV for cache metadata and short-lived records

Deploy To Cloudflare

Use the Deploy to Cloudflare button above to create and deploy your own copy from the public GitHub repository.

The button works for Workers applications. This repository is a pnpm monorepo, so the root package script is the deployment entrypoint:

pnpm deploy:web

This repository’s apps/web/wrangler.jsonc is the live demo at blog.01mvp.com. Do not copy those D1, KV, or R2 ids into a new site.

When you fork the template, copy apps/web/wrangler.example.jsonc to apps/web/wrangler.jsonc, create your own D1 database, R2 bucket, and KV namespace, then replace the placeholders. The deploy script fails early while placeholder IDs or placeholder URLs remain. See configuration.

Required production secrets:

• BETTER_AUTH_SECRET: generate with pnpm auth:secret
• GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET: optional unless GitHub login is enabled
• GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET: optional unless Google login is enabled

Automatic Deploys

This repo includes a GitHub Actions workflow at .github/workflows/cloudflare-deploy.yml. Every push to main installs dependencies, builds the web app, applies D1 migrations to the remote database, and deploys the Worker to Cloudflare.

Add these GitHub repository secrets once:

gh secret set CLOUDFLARE_API_TOKEN --repo 01MVP/blog-starter --body "$CLOUDFLARE_API_TOKEN"
gh secret set CLOUDFLARE_ACCOUNT_ID --repo 01MVP/blog-starter --body "$CLOUDFLARE_ACCOUNT_ID"

The token needs permission to deploy Workers and manage the bound D1, R2, and KV resources used by apps/web/wrangler.jsonc.

Local Development

pnpm install
pnpm dev:web