Skip to content

docs(d1): add D1 Migration Guard to community projects - #33101

Open
MattBridges wants to merge 1 commit into
cloudflare:productionfrom
MattBridges:add-d1-migration-guard
Open

docs(d1): add D1 Migration Guard to community projects#33101
MattBridges wants to merge 1 commit into
cloudflare:productionfrom
MattBridges:add-d1-migration-guard

Conversation

@MattBridges

Copy link
Copy Markdown

Summary

Adds d1-migration-guard to the D1 community projects reference page, alongside the other community CLI tools (e.g. d1-console).

d1-migration-guard is a free, MIT-licensed, zero-dependency CLI that checks D1 migrations for three common footguns before you run wrangler d1 migrations apply:

  • Migration filename ordering / duplicate or gapped numeric prefixes
  • Missing or placeholder database_id in wrangler.toml
  • Destructive SQL patterns (DROP TABLE, DROP COLUMN, unfiltered DELETE)

It reads local files only — it never calls wrangler and never touches a live database.

Repo: https://github.com/MattBridges/d1-migration-guard

Disclosure

I'm the author of this tool. Following the existing entries' format (short factual description + GitHub link, no marketing copy).

@github-actions github-actions Bot added product:d1 D1: https://developers.cloudflare.com/d1/ size/xs labels Aug 29, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit b82633a.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

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

Labels

product:d1 D1: https://developers.cloudflare.com/d1/ size/xs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants