Skip to content

Releases: aloewright/my-cf-template

v0.2.0 — Canonical-template README pass

Choose a tag to compare

@aloewright aloewright released this 28 May 09:16

Docs-only release. The README was rewritten so the repo reads as a canonical template rather than a personal project. No runtime or behavior changes.

Changed

  • Title → "Cloudflare SaaS Template" (aligns with the package, docs site, and v0.1.0 release).
  • Lede reframed; reference-deployment URLs explicitly labeled so it's clear they're the maintainer's instance.
  • Project Layout block fixed — replaced the stale Docusaurus description with the actual docs/ shape (React + Mantine + MDX).
  • Tech Stack picked up rows for Polar, Tabler icons, Nunito, and a CI row.
  • Node prerequisite bumped 20 → 22 (Wrangler 4 + CI already require it).
  • CLOUDFLARE_ACCOUNT_ID example genericized — wrangler whoami rather than a literal account.
  • Auth section now points at docs/src/content/customizing.mdx as a fallback so forks without a deployed docs URL still have a working pointer.
  • npm overrides note expanded to cover both root and docs/ pins.

Added

  • "What's inside" feature summary above the Tech Stack table — 9 bullets for fast scanning.
  • "Docs site" section documenting the docs-as-a-Worker pattern and npm run docs:dev / docs:build / docs:deploy.
  • "Releases" section linking GitHub Releases + CHANGELOG with Keep a Changelog / SemVer attribution.
  • Release + Changelog badges next to the Deploy-to-Cloudflare button.

Full diff

v0.1.0...v0.2.0 — three commits, all under README.md / CHANGELOG.md.

v0.1.0 — Initial release

Choose a tag to compare

@aloewright aloewright released this 28 May 09:01

A reference SaaS on Cloudflare Workers: React + Mantine + MDX, Hono, D1 + Drizzle, Polar billing — with one-click deploy, GitHub Actions auto-deploy, and Dependabot.

Try it

Highlights

  • Single Worker serves the SPA + Hono API + D1 from one origin
  • Polar billing end-to-end: /api/checkout → hosted Polar page → /api/checkout/success → cookie + 302; webhook upserts subscription rows in D1
  • Stub-gated /dashboard with a no-payment Enter demo button so visitors can poke around without buying
  • Custom geometric-mark logo + Nunito typography + dark-mode toggle on both sites
  • Separate React + Mantine + MDX docs site at template-docs.lazee.workers.dev (7 pages: Intro / Architecture / Billing / Protected routes / Database / Deploy / Customizing)
  • One-click Deploy-to-Cloudflare badge — auto-provisions a D1 database on first deploy
  • GitHub Actions redeploy each Worker on push to main with path filters
  • Dependabot weekly (npm + actions); minor+patch grouped, majors as individual PRs

Stack

TypeScript 6, React 19, Vite 8 (Rolldown / Oxc), Mantine 9, Tailwind 4, TanStack Router/Query, Hono, Drizzle, Better Auth (scaffolded), Polar SDK, Wrangler 4, Biome 2.4.

Out of scope (documented swap-in points)

Better Auth wiring, password reset, multi-tier billing, teams, R2. The webhook handler is the production source of truth for subscription state; the cookie is the demo UX stub.

Full changelog

See CHANGELOG.md.