docs: address the Firebase Dynamic Links audience, surface contributing - #22
Merged
Merged
Conversation
Three discovery and on-ramp gaps. FDL was deprecated in 2023 with no official replacement and shut down entirely in August 2025, leaving everyone who relied on it to either pay for an MMP they don't need or build their own. That audience is a closer fit for this project than Branch's is, and the README never spoke to them. Includes the honest half of the mapping: this covers FDL's deferred-attribution side, not its link-hosting side. CONTRIBUTING.md already existed and is good, but nothing in the README linked to it — a contributor had to find it by browsing the file list. Now linked, alongside the good-first-issue label and two things worth knowing before starting: decisions.md is the map, and changes touching recovery or platform behaviour need verifying somewhere real. Contributor avatars via contrib.rocks — no bot, no config, updates itself.
…ative The project isn't an MMP and the README now says so plainly, so claiming to replace one overstates what it does. The Firebase Dynamic Links framing is both more accurate and closer to who actually needs this.
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
1 participant
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.
Three discovery and on-ramp gaps.
Firebase Dynamic Links
FDL was deprecated in May 2023 with no official replacement and shut down completely on 25 August 2025 — every link stopped resolving, deferred linking included. Everyone who relied on it was left choosing between paying for an MMP they don't need and building their own.
That audience is a closer fit for this project than Branch's is, and the README never spoke to them. FDL was never an MMP — it did link hosting, Universal/App Links handling, deferred deep linking and basic click analytics, and nothing else.
The new subsection includes the honest half of the mapping:
page.link)This covers the deferred-attribution half of FDL, not the link-hosting half. Said plainly, because someone arriving with a dead dependency needs to know what they still have to build.
Contributing was invisible
CONTRIBUTING.mdalready existed and is good — setup, per-package test commands, what to verify before opening a PR. Nothing in the README linked to it, so a contributor had to find it by browsing the file list.Now linked, alongside the
good first issuelabel and two things worth knowing before starting:docs/decisions.mdis the map — if something looks wrong, it's often deliberate and the entry says whyContributors
Avatars via contrib.rocks — no bot, no config, updates itself as people contribute. Verified the image URL returns 200.
Sources for the FDL dates: Firebase Dynamic Links Deprecation FAQ, LeanCode