ニュース

01mvp-blog-starter は、Git-managed ドキュメンテーションシステムを備えた Cloudflare-native パーソナルパブリッシングシステムです。

それは2つの内容の表面と出荷します:

• [/blogは、投稿、管理者の書き込み、コメント、RSS、OpenAPIの公開、インポート、エクスポート、およびバックアップの公開バックエンドによって供給されます。
• [/docsは、Fumadocs および GitHub Markdown/MDX が製品ドキュメント、開発者 docs、API ガイド、テンプレートのメモに使われています。

スタック

• タンスタックスタート+タンスタックルータ
• 反応19 +反応コンパイラ
• tailwind CSS + shadcn/ui
• Git 管理文書の Fumadocs
• Paraglide.js(英語と中国語のUIメッセージ)
• クラウドフレアワーカー @cloudflare/vite-plugin -投稿、コメント、設定、ユーザー、セッション、およびAPIトークンのCloudflare D1
• アセット、インポート、エクスポート、およびバックアップ用のCloudflare R2
• キャッシュメタデータと短命レコードのCloudflare KV

Cloudflare へのデプロイ

上記の「デプロイ」ボタンを使用して、パブリックGitHubリポジトリから独自のコピーを作成およびデプロイします。

ボタンは、ワーカーのアプリケーションで動作します。 このリポジトリは pnpm Monorepo なので、root パッケージスクリプトはデプロイメントのエントリポイントです。

このリポジトリの `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