A modern, full-stack blog CMS built entirely within the Cloudflare ecosystem, Flare Stack Blog offers developers a serverless, edge-first platform for creating and managing content. It targets users seeking a highly customizable, performant, and scalable blogging solution that leverages Cloudflare's integrated services like Workers, D1, R2, and Workers AI, providing advanced features and a flexible architecture.

How It Works

This project utilizes Cloudflare Workers as its core execution environment, deeply integrating services such as D1 for SQLite databases, R2 for object storage, KV for caching, and Workers AI for intelligent features. The frontend is built with React 19, TanStack Router/Query, and Tailwind CSS 4, while the backend gateway layer uses Hono, with business logic handled by TanStack Start for SSR and Server Functions. Data access is managed via Drizzle ORM, and authentication is secured through Better Auth with GitHub OAuth. A key architectural choice is the decoupled theming system, allowing complete visual customization via a "Theme Contract" without altering core routing or data logic.

Quick Start & Requirements

• Primary install / run command: bun install followed by bun dev for local development.
• Non-default prerequisites: Bun >= 1.3, a Cloudflare account (for remote D1/R2/KV resources).
• Links: 部署指南, 本地开发, 开发规范, 主题开发教程.

Highlighted Details

• Cloudflare Ecosystem Integration: Extensive use of Workers, D1, R2, KV, Durable Objects, Workflows, Queues, Workers AI, and Images for a unified serverless experience.
• AI-Assisted Features: Integrates Cloudflare Workers AI for capabilities like content moderation, article summarization, and contextual review.
• Decoupled Theming: A flexible theme system allows full replacement of the user-facing visual layer via a Theme Contract, separating presentation from business logic.
• Rich Content Management: Features include a TipTap rich text editor with Shiki code highlighting, version history, nested comments with AI moderation, an R2-based media library, and comprehensive SEO enhancements (Schema.org, RSS, Sitemap).

Maintenance & Community

A Telegram group is available for community discussion and support. The repository includes a CONTRIBUTING.md file outlining development guidelines.

Licensing & Compatibility

The project is licensed under the MIT License, permitting broad use and modification. It is specifically designed for and requires deployment on Cloudflare Workers.

Limitations & Caveats

This project is exclusively designed for the Cloudflare ecosystem and only supports deployment on Cloudflare Workers. While local development is supported using Miniflare, data simulated locally does not synchronize with remote Cloudflare resources.