mobile-patches

Central repo for maintaining patched 3rd party libraries used by the mobile-monorepo. Each patched package lives on its own branch; the monorepo consumes it by pinning to that branch.

Layout

• master — this README only. No package source.
• One branch per package, named <short-name>/<upstream-version>, e.g. rn-masked-view/0.3.1. The branch holds the package source with our patches.

Upstream

Each branch tracks the original library repo as upstream, so we can pull new commits and re-apply our patches:

git remote add upstream https://github.com/<original-owner>/<repo>.git
git fetch upstream

Monorepo usage

Reference this repo and the branch in package.json:

"@react-native-masked-view/masked-view": "https://github.com/<org>/mobile-patches.git#rn-masked-view/0.3.1"

The branch name encodes the version, so it is clear which patched build is used.

Workflows

New package

git checkout --orphan rn-masked-view/0.3.1
git rm -rf .
# add upstream source at the target version
git remote add upstream https://github.com/<original-owner>/<repo>.git
git push -u origin rn-masked-view/0.3.1

Pull upstream updates

git checkout rn-masked-view/0.3.1
git fetch upstream
git merge upstream/<tag>   # resolve conflicts, keep patches
git push

New version — create a fresh branch (rn-masked-view/0.4.0), bring in the new source, re-apply patches, update the monorepo reference.

Conventions

• master stays README-only.
• One package per branch.
• Branch version = the patched upstream version.