Improvements for Mainnet Forking Docs #1596
Merged
+1,106
−2
Conversation
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
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
jribbink
changed the title
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
briandoyle81
reviewed
Dec 9, 2025
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
|
|
||
| Just like mocking dependencies in unit tests, you can **mock real mainnet contracts** by deploying modified versions—perfect for testing upgrades, bug fixes, or alternative implementations against real production state. | ||
|
|
||
| Configure the mock in `flow.json`, then deploy to the forked emulator. Your mock takes precedence while other contracts use real mainnet versions. |
Contributor
There was a problem hiding this comment.
Are we overriding FlowToken in this example? Can we provide the code for the mock contract and run it?
It can be simple.
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Show resolved
Hide resolved
docs/blockchain-development-tutorials/cadence/emulator-fork-testing/index.md
Outdated
Show resolved
Hide resolved
briandoyle81
previously requested changes
Dec 11, 2025
Contributor
briandoyle81
left a comment
briandoyle81
left a comment
There was a problem hiding this comment.
Great overall, requested some changes inline!
|
|
||
| # Interactive Testing with Forked Emulator | ||
|
|
||
| This tutorial teaches you how to run your app, E2E tests, and manual explorations against a snapshot of Flow mainnet using `flow emulator --fork`. You'll learn how to connect your frontend to production-like state, test user flows with real contracts and data, and debug issues interactively—all without deploying to a live network. |
Member
There was a problem hiding this comment.
Would explain the why forking here more
chasefleming
approved these changes
Dec 12, 2025
Contributor
Author
|
follow up PR here, still working on it but these comments have not been forgotten |
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.
Closes #1595
Closes #1611