{"id":13452171,"url":"https://github.com/react-everywhere/re-start","last_synced_at":"2025-05-15T15:05:25.309Z","repository":{"id":57136944,"uuid":"77784093","full_name":"react-everywhere/re-start","owner":"react-everywhere","description":"react-native template to target multiple platforms :globe_with_meridians: :iphone: :computer: with single codebase.","archived":false,"fork":false,"pushed_at":"2020-06-02T21:41:41.000Z","size":492,"stargazers_count":1300,"open_issues_count":38,"forks_count":85,"subscribers_count":48,"default_branch":"master","last_synced_at":"2024-10-29T17:50:45.723Z","etag":null,"topics":["android","boilerplate","cross-platform","electron","iphone","react","react-native","starter-kit"],"latest_commit_sha":null,"homepage":"https://medium.com/@amoghbanta/write-once-use-everywhere-with-react-native-d6e575efe58e#.nfl50gwfg","language":"JavaScript","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-everywhere.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":null,"security":null,"support":null}},"created_at":"2017-01-01T15:18:41.000Z","updated_at":"2024-10-22T20:22:32.000Z","dependencies_parsed_at":"2022-09-01T04:01:01.995Z","dependency_job_id":null,"html_url":"https://github.com/react-everywhere/re-start","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-everywhere%2Fre-start","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-everywhere%2Fre-start/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-everywhere%2Fre-start/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/react-everywhere%2Fre-start/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/react-everywhere","download_url":"https://codeload.github.com/react-everywhere/re-start/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247730069,"owners_count":20986404,"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":["android","boilerplate","cross-platform","electron","iphone","react","react-native","starter-kit"],"created_at":"2024-07-31T07:01:15.870Z","updated_at":"2025-04-07T21:15:50.506Z","avatar_url":"https://github.com/react-everywhere.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# re-start :globe_with_meridians: :iphone: :computer:\n\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n[![re-start](https://s28.postimage.org/4a0zw1egd/re-start_1.png)](https://postimg.org/image/6elcx4g2x/)\n\n## Aim of the project\n* Target multiple platforms (Android, iOS, Web, Windows[UWP] and Electron[macOS,\n  Linux, Windows]) with react native' APIs and a single codebase.\n* Follow best practices while doing the above.\n* Cut out the time and effort it takes to setup the project (based on\n  `create-react-app`).\n* Achieve [write once run everywhere](https://en.wikipedia.org/wiki/Write_once,_run_anywhere)\n  with react-native (though react strictly says 'Learn once use anywhere').\n* Mitigate git cloning or manual upgrading of boiler plates, which is possible\n  because this project is a react-native\n  [template](https://github.com/facebook/react-native/pull/12548). :tada:\n\n## Structure of the project\n\n* This project comprises of several templates that are curated keeping in mind\n  the various use cases of initiating a new project. Based on your requirements\n  and preferences, you can choose a templates that suits your you case the best.\n\n| Template Name | Description | Version |\n| ------------- | ----------- | ------- |\n| `re-base`     | The most basic version that runs on all platforms | [![npm version](https://badge.fury.io/js/react-native-template-re-base.svg)](https://badge.fury.io/js/react-native-template-re-base)   |\n| `re-dux`      | `re-base` with redux wired out of the box         | [![npm version](https://badge.fury.io/js/react-native-template-re-dux.svg)](https://badge.fury.io/js/react-native-template-re-dux)     |\n| `re-route`    | `re-base` with react-router wired out of the box  | [![npm version](https://badge.fury.io/js/react-native-template-re-route.svg)](https://badge.fury.io/js/react-native-template-re-route) |\n| `re-start`    | `re-base` combined with redux and react-router    | [![npm version](https://badge.fury.io/js/react-native-template-re-start.svg)](https://badge.fury.io/js/react-native-template-re-start) |\n\n## Usage\n\n### Pre-requisites\n- [Node.js \u0026 npm](https://docs.npmjs.com/getting-started/installing-node)\n- react-native CLI (`npm install -g react-native-cli`)\n\n### Install\n\n1. Create a new react-native project using `react-native-cli` and specify\n   `re-base` as a template:\n   ```sh\n   react-native init \u003cYour Project Name\u003e --template re-base\n   ```\n2. React Native don't support templates inheritance. If you want to use a\n   derived template like `re-dux` or `re-route`, install them directly on top of\n   the just created project. You'll probably get a warning about the project\n   already exists, just say it `yes` to overwrite the needed files.\n   ```sh\n   react-native init \u003cYour Project Name\u003e --template re-dux\n   react-native init \u003cYour Project Name\u003e --template re-route\n   react-native init \u003cYour Project Name\u003e --template re-start\n   ```\n   `re-start` template depend of both `re-route` and `re-dux`, be sure to\n   install them first in that order.\n3. Since `react-native-template` doesn't support adding custom scripts to\n   `package.json`, exec `./finishInstall.js` to finish the project\n   configuration.\n4. Your project should now be ready to build apps for the different platforms.\n\n### Run the project on a specific platform\n\n#### Android/iOS\n```sh\nnpm/yarn run android\nnpm/yarn run ios\n```\nIn case of problems, this\n[tutorial](https://facebook.github.io/react-native/docs/running-on-device.html)\nwill help you to configure your environment.\n\n#### Desktop (Electron)\n```sh\nnpm/yarn run electron\n```\n\n#### Web\n```sh\nnpm/yarn run web\n```\n\n#### Windows\n```sh\nnpm/yarn run windows\n```\nWindows platforms needs to have installed the `Windows 10 SDK Build 14393` to be\nable to be build. A certificate is needed to sign the binary, follow the\n[instructions](https://msdn.microsoft.com/en-us/library/windows/apps/br230260(v=vs.110).aspx)\nto create or update the sign certificate. After that, a pop-up window would\nappear during the first time you exec the build process asking to install the\ncertificate you've just created, just accept it.\n\n### Build for production\n\n#### Android\n```sh\nnpm/yarn run android:release\n```\n\n#### Electron\n```sh\nnpm/yarn run electron:release\n```\nIf you are running this on Linux or OSX, this will need you have `wine` 1.6\ninstalled in your system because setting the Windows app icon makes usage\ninternally of the [node-rcedit](https://github.com/atom/node-rcedit) package.\n\n#### iOS\n```sh\nnpm/yarn run ios:release\n```\n\n#### Web\n```sh\nnpm/yarn run web:release\n```\nThis will build your production ready bundle\n\n#### Windows\n```sh\nnpm/yarn run windows:release\n```\n\n## Some very useful cross platform compatible libraries\n- [react-native-vector-icons](https://github.com/oblador/react-native-vector-icons)\n- [axios](https://github.com/mzabriskie/axios)\n- [react-router](https://github.com/ReactTraining/react-router)\n- [re-render](https://github.com/amoghbanta/re-render) (this is experimental and a WIP)\n\n## Progress\n- [x] support for web ([react-native-web_improved](https://github.com/piranna/react-native-web_improved))\n- [x] support for Windows ([react-native-windows](https://github.com/ReactWindows/react-native-windows))\n- [x] Support for electron\n- [x] Compatibility with React 16\n- [ ] Add Docs and FAQs\n- [ ] Configure Travis and Greenkeeper\n- [ ] Interactive CLI to create templates and components\n\n## Running demo on Web, Android, iOS, Windows(Universal) and Electron\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://s28.postimage.org/gmgva9rrh/58961a12afcd1276062762.gif\" height=\"450\"  width=\"260\"\u003e\n\u003cimg src=\"https://s28.postimage.org/nbneqad3h/58961a2a030da447844552.gif\" height=\"450\"  width=\"260\"\u003e\n\u003cimg src=\"https://s28.postimage.org/aa1q0fop9/589619ef1b623465256988.gif\" height=\"450\"  width=\"260\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://s28.postimage.org/yuzzepj7b/ezgif_com_video_to_gif.gif\" height=\"450\"  width=\"260\"\u003e\n\u003cimg src=\"https://s28.postimage.org/edxytckih/ezgif.com-video-to-gif.gif\" height=\"450\"  width=\"350\"\u003e\n\u003c/p\u003e\n\n## Contributors\n\nThanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n| [\u003cimg src=\"https://avatars0.githubusercontent.com/u/7105580?v=4\" width=\"100px;\"/\u003e\u003cbr /\u003e\u003csub\u003eAmogh Banta\u003c/sub\u003e](http://www.amoghbanta.com)\u003cbr /\u003e[💻](https://github.com/amoghbanta/re-start/commits?author=amoghbanta \"Code\") [🎨](#design-amoghbanta \"Design\") [📖](https://github.com/amoghbanta/re-start/commits?author=amoghbanta \"Documentation\") [🐛](https://github.com/amoghbanta/re-start/issues?q=author%3Aamoghbanta \"Bug reports\") [🤔](#ideas-amoghbanta \"Ideas, Planning, \u0026 Feedback\") [⚠️](https://github.com/amoghbanta/re-start/commits?author=amoghbanta \"Tests\") | [\u003cimg src=\"https://avatars1.githubusercontent.com/u/532414?v=4\" width=\"100px;\"/\u003e\u003cbr /\u003e\u003csub\u003eJesús Leganés-Combarro\u003c/sub\u003e](http://pirannafs.blogspot.com)\u003cbr /\u003e[💻](https://github.com/amoghbanta/re-start/commits?author=piranna \"Code\") [🤔](#ideas-piranna \"Ideas, Planning, \u0026 Feedback\") [🐛](https://github.com/amoghbanta/re-start/issues?q=author%3Apiranna \"Bug reports\") [⚠️](https://github.com/amoghbanta/re-start/commits?author=piranna \"Tests\") [👀](#review-piranna \"Reviewed Pull Requests\") [📖](https://github.com/amoghbanta/re-start/commits?author=piranna \"Documentation\") | [\u003cimg src=\"https://avatars2.githubusercontent.com/u/1699793?v=4\" width=\"100px;\"/\u003e\u003cbr /\u003e\u003csub\u003eAnkit Popli\u003c/sub\u003e](https://ankitpopli.me)\u003cbr /\u003e[👀](#review-ankitpopli1891 \"Reviewed Pull Requests\") [🤔](#ideas-ankitpopli1891 \"Ideas, Planning, \u0026 Feedback\") [🐛](https://github.com/amoghbanta/re-start/issues?q=author%3Aankitpopli1891 \"Bug reports\") | [\u003cimg src=\"https://avatars1.githubusercontent.com/u/177822?v=4\" width=\"100px;\"/\u003e\u003cbr /\u003e\u003csub\u003eChristopher Hein\u003c/sub\u003e](http://chrishein.com)\u003cbr /\u003e[📖](https://github.com/amoghbanta/re-start/commits?author=christopherhein \"Documentation\") [🐛](https://github.com/amoghbanta/re-start/issues?q=author%3Achristopherhein \"Bug reports\") | [\u003cimg src=\"https://avatars0.githubusercontent.com/u/593122?v=4\" width=\"100px;\"/\u003e\u003cbr /\u003e\u003csub\u003eDuncanMacWeb\u003c/sub\u003e](https://github.com/DuncanMacWeb)\u003cbr /\u003e[💻](https://github.com/amoghbanta/re-start/commits?author=DuncanMacWeb \"Code\") |\n| :---: | :---: | :---: | :---: | :---: |\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\nFull list of contributors can be found [here](https://github.com/react-everywhere/re-start/graphs/contributors).\n\n## Companies that contribute to `re-start`'s development\n\n- [DigiCred Technologies](https://github.com/DigiCred)\n- [Fundació i2CAT](http://www.i2cat.net/)\n- [Quantum BA](https://quantum-ba.com/)\n- [UnifyMe](http://www.unifyme.me/)\n\n## LICENSE\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freact-everywhere%2Fre-start","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freact-everywhere%2Fre-start","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freact-everywhere%2Fre-start/lists"}