{"id":13848721,"url":"https://react-native-community.github.io/upgrade-helper/","last_synced_at":"2025-07-12T13:32:16.496Z","repository":{"id":38365734,"uuid":"175489142","full_name":"react-native-community/upgrade-helper","owner":"react-native-community","description":"⚛️ A web tool to support React Native developers in upgrading their apps.","archived":false,"fork":false,"pushed_at":"2024-04-25T14:00:55.000Z","size":38070,"stargazers_count":3452,"open_issues_count":29,"forks_count":106,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-05-01T12:27:34.291Z","etag":null,"topics":["react","react-native","rn-diff","rn-diff-purge","upgrade-tool"],"latest_commit_sha":null,"homepage":"https://react-native-community.github.io/upgrade-helper","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/react-native-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-13T19:52:36.000Z","updated_at":"2024-07-19T23:00:17.413Z","dependencies_parsed_at":"2024-07-19T22:59:57.637Z","dependency_job_id":"693cb81e-fb1c-490e-95c3-2b1fac285133","html_url":"https://github.com/react-native-community/upgrade-helper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-native-community%2Fupgrade-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-native-community%2Fupgrade-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-native-community%2Fupgrade-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-native-community%2Fupgrade-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/react-native-community","download_url":"https://codeload.github.com/react-native-community/upgrade-helper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213949767,"owners_count":15661673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["react","react-native","rn-diff","rn-diff-purge","upgrade-tool"],"created_at":"2024-08-04T19:00:56.200Z","updated_at":"2024-08-04T19:03:09.457Z","avatar_url":"https://github.com/react-native-community.png","language":"TypeScript","funding_links":[],"categories":["React Native"],"sub_categories":["🛠 Tools"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"/src/assets/logo.svg\" width=\"150\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eUpgrade Helper\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A web tool to help you upgrade your React Native app with ease! 🚀\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://circleci.com/gh/react-native-community/upgrade-helper\"\u003e\u003cimg src=\"https://circleci.com/gh/react-native-community/upgrade-helper.svg?style=shield\" alt=\"CircleCI\" title=\"CircleCI\"\u003e\u003c/a\u003e\n  \u003ca href=\"http://makeapullrequest.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=shield\" alt=\"PRs Welcome\" title=\"PRs Welcome\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://react-native-community.github.io/upgrade-helper\"\u003e\n    Open the tool!\n  \u003c/a\u003e\n\u003c/p\u003e\n\n![Image showing a screenshot of Upgrade Helper with the phrase \"You are gonna love this!\"](https://user-images.githubusercontent.com/6207220/61382138-7a3a6780-a8ac-11e9-8c74-b4cb4830e131.png)\n\n## ⚙️ How to use\n\n[![How to upgrade using upgrade-helper](https://img.youtube.com/vi/fmh_ZGHh_eg/0.jpg)](https://www.youtube.com/watch?v=fmh_ZGHh_eg)\n\n## 🎩 How it works\n\nThe **Upgrade Helper** tool aims to provide the full set of changes happening between any two versions, based on the previous work done in the [rn-diff-purge](https://github.com/react-native-community/rn-diff-purge) project:\n\n\u003e This repository exposes an untouched React Native app generated with the CLI `react-native init RnDiffApp`. Each new React Native release causes a new project to be created, removing the old one, and getting a diff between them. This way, the diff is always clean, always in sync with the changes of the init template.\n\nThis will help you see what changes you need to do in your code.\n\nAside from this, the tool provides you a couple of cool extra features:\n\n- inline comments to help you with more insights about precise files\n- a set of links with further explanations on what the version you are upgrading to\n- a handy \"done\" button near each file to help you keep track of your process\n- a download button for new binary files\n- the ability to toggle all files by holding the alt key and clicking on expand/collapse\n- ...and we are planning many more features! Check the [enhancement tag](https://github.com/react-native-community/upgrade-helper/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aenhancement) in the issue section.\n\n## 💻 Contributing\n\nIf you want to help us making this better, you can start by forking the project and follow these steps to testing it out locally:\n\n1. Clone the project\n1. Run `yarn install`\n1. Run `yarn start`\n1. Open `http://localhost:3000`\n1. Select starting \u0026 target versions\n1. Click the `Show me how to upgrade` button\n\nAfter which, you can create a branch to to make your changes and then open a PR against this repository following the provided template 🤗\n\n## 📣 Acknowledgments\n\nThis project proudly uses [`rn-diff-purge`](https://github.com/react-native-community/rn-diff-purge), [`react-diff-view`](https://github.com/otakustay/react-diff-view) and [`create-react-app`](https://github.com/facebook/create-react-app).\n\n## 📝 License \u0026 CoC\n\nThis project is released under the [MIT license](./LICENSE).\n\nMorerover, this projects adopts the [Contributor Covenant Code of Conduct](./CODE_OF_CONDUCT.md) and all contributors are expected to follow it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/react-native-community.github.io%2Fupgrade-helper%2F","html_url":"https://awesome.ecosyste.ms/projects/react-native-community.github.io%2Fupgrade-helper%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/react-native-community.github.io%2Fupgrade-helper%2F/lists"}