Skip to content

docs: plan KV-backed fast content deploy#201

Open
vibe-dex wants to merge 1 commit into
mainfrom
vibe-dex/kv-content-fast-deploy
Open

docs: plan KV-backed fast content deploy#201
vibe-dex wants to merge 1 commit into
mainfrom
vibe-dex/kv-content-fast-deploy

Conversation

@vibe-dex

@vibe-dex vibe-dex commented May 25, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds FAST_DEPLOY_PLAN.md — an implementation plan to decouple CMS content from worker deploys by moving Studio writes to per-site Cloudflare KV namespaces while keeping the bundled blocks.gen snapshot as a fallback.
  • Locks in three architectural decisions: per-block storage granularity, revision-key polling for cross-isolate invalidation (5–10s eventual consistency), and a full async refactor of loadBlock/resolve.ts.
  • Splits work explicitly across the @decocms/start framework (new BlockSource abstraction + KV writer + migration scripts), site CI (new sync-content-to-kv.yml, path-filtered deploy.yml), and Studio (POST-to-site publish path with a per-site capability flag).

Test plan

  • Plan-only PR — no code yet; reviewers confirm scope, DO/DON'T boundaries, and rollout stages.

🤖 Generated with Claude Code


Summary by cubic

Adds FAST_DEPLOY_PLAN.md outlining KV-backed fast content deploys: Studio writes go to per-site Cloudflare KV with bundled blocks.gen as a fallback, so content changes no longer trigger worker deploys. The plan defines per-block storage, revision-key polling for cross-isolate invalidation, and an async BlockSource read path across @decocms/start, site CI, and Studio.

  • Migration
    • Provision a per-site KV namespace and bind it as DECO_KV.
    • Run migrate-blocks-to-kv once, deploy the updated @decocms/start, and enable the site flag.
    • Add sync-content-to-kv.yml for content-only syncs; run deploy.yml only on code changes.

Written for commit 59504c3. Summary will update on new commits. Review in cubic

…r deploys)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vibe-dex vibe-dex requested a review from a team May 25, 2026 18:20

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant