Repository navigation
[Flagship] Document the local flag store for wrangler dev - #32879
Open
akshitsinha wants to merge 3 commits into
Open
akshitsinha wants to merge 3 commits into
akshitsinha wants to merge 3 commits into
Conversation
akshitsinha
requested review from
a team,
GregBrimble,
MattieTK,
WalshyDev,
irvinebroque,
korinne,
palashgo,
roerohan and
vy-ton
as code owners
August 20, 2026 06:56
github-actions
Bot
added
product:workers
Contributor
AI Review✅ Reviewed 👉 Fix in your agent 👈Fix the following review findings in PR #32879 (https://github.com/cloudflare/cloudflare-docs/pull/32879).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.
After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.
The comment must come before the commit because the next review reads PR comments.
## Style Guide
- S-0bf546c7 | src/content/docs/flagship/reference/wrangler-commands.mdx:64 | Semicolon joins two independent clauses
The style guide requires breaking semicolon-joined independent clauses into two sentences. Here `pull` writes to the default local store in `.wrangler/state` and `pass --persist-to <DIRECTORY> ...` are both independent clauses joined by a semicolon.Style GuideSkipped: no new docs content changes since the last review.
Commands
|
github-actions
Bot
assigned
palashgo,
roerohan,
thebongy,
GregBrimble,
irvinebroque,
korinne,
MattieTK,
vy-ton and
WalshyDev
2 of 5 tasks
akshitsinha
force-pushed
the
asinha/flagship-local-dev-docs
branch
from
August 20, 2026 07:05
bf62fea to
e6d2a45
Compare
akshitsinha
marked this pull request as draft
August 22, 2026 16:53
2 of 5 tasks
irvinebroque
requested review from
a team,
ishita1805 and
vaibhavshn
as code owners
September 4, 2026 20:00
irvinebroque
marked this pull request as draft
September 4, 2026 20:49
Contributor
|
@akshitsinha This draft pull request has had no activity for 3 days. It will close after 7 days of inactivity. Transition to ready for review if ready. A codeowner can comment |
akshitsinha
force-pushed
the
asinha/flagship-local-dev-docs
branch
from
September 21, 2026 09:43
e7d27b0 to
88ddba9
Compare
Contributor
|
@akshitsinha This draft pull request has had no activity for 3 days. It will close after 7 days of inactivity. Transition to ready for review if ready. A codeowner can comment |
Contributor
|
@akshitsinha Closing this draft pull request after 7 days of inactivity. Re-open at a later date and transition to ready for review when you are ready if you seek review. |
akshitsinha
force-pushed
the
asinha/flagship-local-dev-docs
branch
from
October 6, 2026 06:38
88ddba9 to
81ef66d
Compare
akshitsinha
marked this pull request as ready for review
October 6, 2026 06:38
Contributor
Review coverage✅ All 6 ownership areas are covered. ✅ 6 areas already covered
CODEOWNERS mappings for displayed areas (6)
|
Member
Author
|
A Wrangler release that supports using Flagship in Miniflare, including Local Explorer, will be published this week! |
vaibhavshn
approved these changes
Oct 6, 2026
irvinebroque
reviewed
Oct 7, 2026
| date: 2026-10-13 | ||
| --- | ||
|
|
||
| **[Wrangler](/workers/wrangler/)** now evaluates [Flagship](/flagship/) bindings against a local flag store during [`wrangler dev`](/workers/wrangler/commands/general/#dev). The store starts empty, so flags fall back to the default you pass at the call site until you populate it. |
irvinebroque
reviewed
Oct 7, 2026
| Copy flags from the remote app into that store: | ||
|
|
||
| ```sh | ||
| wrangler flagship flags pull <APP_ID> |
Contributor
There was a problem hiding this comment.
We can’t automatically pull for people?
irvinebroque
approved these changes
Oct 7, 2026
irvinebroque
left a comment
irvinebroque
left a comment
Contributor
There was a problem hiding this comment.
Stamping but can we make sure we are providing guidance on how to do this with cf cli?
Collaborator
|
@akshitsinha Can you confirm if the changes/work on this PR is done? 👀 Is it ready to merge/close? |
Member
Author
Not yet, working on supporting cf cli as well. I'll merge once its released. Hopefully in another week or two. :D |
neelakolkar-cf
approved these changes
Oct 23, 2026
Open
2 of 5 tasks
akshitsinha
force-pushed
the
asinha/flagship-local-dev-docs
branch
from
October 26, 2026 11:43
81ef66d to
ed7e2e5
Compare
Flagship bindings now evaluate against a local flag store during wrangler dev instead of the remote app. The configuration page said the opposite, so replace that section with the local store workflow: pull, --local flag commands, and remote: true. Also add the Flagship binding to the Wrangler configuration reference, list it in the local development binding tables, and add a changelog entry.
akshitsinha
force-pushed
the
asinha/flagship-local-dev-docs
branch
from
October 27, 2026 05:49
99c0226 to
88cd720
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the local flag store that Flagship bindings now use during
wrangler dev.The Flagship configuration page currently states the opposite of the new behaviour:
Bindings now resolve against a local, persisted store by default (Wrangler v4.135.0 and later), so
wrangler devworks offline and local changes no longer touch production flags. Flags fall back to the default passed at the call site until the store is populated, so the pull step needs to be discoverable.Changes:
wrangler flagship flags pull,--localflag commands,remote: true, and Local Explorer.flagshipcommand page: added a--localnote, matching the existing Workflows pattern.flagshipbinding (binding,app_id,remote) to the bindings reference and the non-inheritable keys list.Implementation PRs
All three are merged in
cloudflare/workers-sdk:[miniflare] Simulate Flagship bindings locally. Local flag store, evaluation, and the admin API.[wrangler] Add local Flagship development commands. Local-by-default bindings,remote: true,flags pull, and--localon flag commands (Wrangler v4.135.0).[miniflare] Manage Flagship flags in Local Explorer. Create, edit, toggle, delete, and evaluate flags in Local Explorer. Merged on 2026-10-05.Documentation checklist