中 Readme

01mvp-blog-starter - это персональная издательская система Cloudflare с системой документации под управлением Git.

Он поставляется с двумя поверхностями содержимого:

• /blog работает на основе издательского бэкэнда для сообщений, написания администратором, комментариев, RSS, публикации OpenAPI, импорта, экспорта и резервных копий.
• /docs работает на Fumadocs и GitHub Markdown/MDX для документов о продуктах, документов разработчика, руководств по API и заметок шаблонов.

##Стек

TanStack Start + маршрутизатор TanStack Компилятор React 19 + React Tailwind CSS + shadcn/ui

• Фумадокс для документации, управляемой Git Paraglide.js для английского и китайского UI сообщений Работники Cloudflare через @cloudflare/vite-plugin Cloudflare D1 для сообщений, комментариев, настроек, пользователей, сессий и токенов API Cloudflare R2 для активов, импорта, экспорта и резервного копирования Cloudflare KV для метаданных кэша и коротких записей

Развернуть в Cloudflare

Используйте кнопку Deploy to Cloudflare выше, чтобы создать и развернуть свою собственную копию из публичного репозитория GitHub.

Кнопка работает для рабочих приложений. Это хранилище является монорепо pnpm, поэтому скрипт корневого пакета является точкой входа в развертывание:

Это хранилище “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