한국어 README

01mvp-blog-starter는 Git-managed 문서 시스템을 갖춘 Cloudflare-native 개인 출판 시스템입니다.

그것은 2개의 내용 표면으로 발송합니다:

• /blog]는 게시물, 관리자 작성, 댓글, RSS, OpenAPI 출판, 수입, 수출 및 백업에 대한 게시 백엔드에 의해 구동됩니다.
• /docs는 제품 문서, 개발자 문서, API 가이드 및 템플릿 노트에 대한 Fumadocs 및 GitHub Markdown/MDX에 의해 구동됩니다.

스택

• TanStack 시작 + TanStack 라우터
• React 19 + React 컴파일러
• 꼬리바람 CSS + shadcn/ui
• Git-managed 문서에 대한 Fumadocs
• 한국어 및 중국어 UI 메시지 Paraglide.js
• Cloudflare 노동자를 통해 [T2]
• 포스트, 의견, 설정, 사용자, 세션 및 API 토큰을위한 Cloudflare D1
• 자산, 수입, 수출 및 백업을위한 Cloudflare R2
• 시렁 메타데이터와 부족한 기록을 위한 Cloudflare KV

Cloudflare에 배포

Deploy를 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