{"id":16797450,"url":"https://github.com/thetechie/create-react-primitive-app","last_synced_at":"2025-04-11T00:12:47.287Z","repository":{"id":57210658,"uuid":"102012284","full_name":"theTechie/create-react-primitive-app","owner":"theTechie","description":"Create react cross platform apps with no build configuration. Mixture of create-react-app and create-react-native-app","archived":false,"fork":false,"pushed_at":"2018-02-11T13:26:21.000Z","size":1331,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T21:01:46.366Z","etag":null,"topics":["create-react-app","create-react-native-app","react","react-native","react-primitives"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theTechie.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-08-31T14:55:24.000Z","updated_at":"2019-09-09T00:02:03.000Z","dependencies_parsed_at":"2022-08-31T05:03:12.193Z","dependency_job_id":null,"html_url":"https://github.com/theTechie/create-react-primitive-app","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/theTechie%2Fcreate-react-primitive-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theTechie%2Fcreate-react-primitive-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theTechie%2Fcreate-react-primitive-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theTechie%2Fcreate-react-primitive-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theTechie","download_url":"https://codeload.github.com/theTechie/create-react-primitive-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247861519,"owners_count":21008509,"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":["create-react-app","create-react-native-app","react","react-native","react-primitives"],"created_at":"2024-10-13T09:22:23.292Z","updated_at":"2025-04-11T00:12:47.270Z","avatar_url":"https://github.com/theTechie.png","language":"JavaScript","readme":"# Create React Primitive App\n[![npm version](https://badge.fury.io/js/create-react-primitive-app.svg)](https://badge.fury.io/js/create-react-primitive-app)\n\nCreate React cross-platform apps with no build configuration.\n\n* [Getting Started](#getting-started)\n* [User Guide](https://github.com/theTechie/create-react-primitive-app/blob/master/react-primitive-scripts/template/README.md)\n\nOnce you're up and running with Create React Primitive App, visit [this tutorial](https://facebook.github.io/react-native/docs/tutorial.html) for more information on building apps with React Native.\n\n## Quick Overview\n\nMake sure you have Node v6 or later installed. No Xcode or Android Studio installation is required.\n\n```sh\n$ npm install -g create-react-primitive-app\n$ create-react-primitive-app my-app\n$ cd my-app/\n$ npm start\n```\n\nInstall the [Expo](https://expo.io) app on your iOS or Android phone, and use the QR code in the terminal to open your app. Find the QR scanner on the Projects tab of the app. When you're ready to share your project with others (for example, by deploying to an app store), read the [Sharing \u0026 Deployment](https://github.com/theTechie/create-react-primitive-app/blob/master/react-primitive-scripts/template/README.md#sharing-deployment) section of the User Guide.\n\nCreate React Primitive App allows you to work with all of the [Components and APIs](https://facebook.github.io/react-native/docs/getting-started.html) in React Native, as well as most of the [JavaScript APIs](https://docs.expo.io/versions/latest/sdk/index.html) that the Expo App provides.\n\n## Sections\n\n* [Getting Started](#getting-started)\n* [Philosophy](#philosophy)\n* [Support and Contact](#support-and-contact)\n* [FAQs](#faqs)\n* [Contributing](#contributing)\n\n## Getting Started\n\n### Installation\n\nInstall it once globally:\n\n```sh\n$ npm install -g create-react-primitive-app\n  # or\n$ yarn global add create-react-primitive-app\n```\n### Creating an App\n\nTo create a new app, run:\n\n```sh\n$ create-react-primitive-app my-app\n$ cd my-app\n```\n\nThis will create a directory called `my-app` inside the current working directory. Inside `my-app`, this will generate the initial project structure and install all of its dependencies.\n\nIf you're familiar with React Native already, you won't find any `ios` or `android` directories in this project, just JavaScript. Once this installation is done, there are some commands you can run in the project directory:\n\n#### `npm start`\n\nRuns your app in development mode with an interactive prompt. To run it without a prompt, use the `--no-interactive` flag.\n\nOpen it in the [Expo app](https://expo.io) on your phone to view it. It will reload if you save edits to your files, and you will see build errors and logs in the terminal.\n\n#### `npm test`\n\nRuns the [jest](https://github.com/facebook/jest) test runner on your tests.\n\n#### `npm run ios`\n\nLike `npm start`, but also attempts to open your app in the iOS Simulator if you're on a Mac and have it installed.\n\n#### `npm run android`\n\nLike `npm start`, but also attempts to open your app on a connected Android device or emulator. Requires an installation of Android build tools (see [React Native docs](https://facebook.github.io/react-native/docs/getting-started.html) for detailed setup).\n\n#### `npm run eject`\n\nThis will start the process of \"ejecting\" from Create React Primitive App's build scripts. You'll be asked a couple of questions about how you'd like to build your project.\n\n**Warning:** Running eject is a **permanent** action. Please use a version control system, such as git, so you can revert back if necessary. An ejected app will require you to have an [Xcode and/or Android Studio environment](https://facebook.github.io/react-native/docs/getting-started.html) set up.\n\n## Philosophy\n\n* **Minimal \"Time to Hello World\"**: Create React Primitive App should reduce the setup time it takes to try building a mobile app to the absolute minimum, ideally on par with React web development (especially as seen with [Create React App](https://github.com/facebookincubator/create-react-app)).\n* **Develop on Your Device**: It should be easy to develop on a physical device when you want to test how your app feels and responds to inputs.\n* **One Build Tool**: If you just want to get started with React Native, you shouldn't need to install Xcode, Android Studio, NDKs, or mess with environment variables.\n* **No Lock-In**: You can always \"eject\" to your own build setup if you need to write custom native code or modify how your app is built.\n\n## Support and Contact\n\nIf you're having issues with Create React Primitive App, please make sure:\n\n* The issue is not covered in the [Getting Started](https://github.com/theTechie/create-react-primitive-app#getting-started) or [User Guide](https://github.com/theTechie/create-react-primitive-app/blob/master/react-primitive-scripts/template/README.md) documentation\n* There is not already an [open issue](https://github.com/theTechie/create-react-primitive-app/issues) for your particular problem\n\nIf you've checked the documentation and currently open issues, please either open a new GitHub issue, [find @gaganblr on Twitter](https://twitter.com/gaganblr), **Please do not DM or email project maintainers directly**, as it's very important that support takes place in public locations where others can benefit from the conversation.\n\n## FAQs\n\n### What API specification should I be looking at while developing?\n\nApps made with Create React Primitive App support everything in the Components and APIs sections of the [React Native Documentation](https://facebook.github.io/react-native/docs/getting-started.html).\n\nApps made with Create React Primitive App also support most of the JavaScript-to-Native APIs provided by the [Expo SDK](https://docs.expo.io/versions/latest/sdk/index.html), since they are loaded by the Expo app.\n\n### What are the limitations of Create React Primitive App?\n\nThe main limitation of a Create React Primitive App project is that it must be written in pure JavaScript and not have any dependencies which rely on custom native code (i.e. ones which require running `react-native link` to work). This allows the projects to load directly on a phone without native compilation, and also means that it's not necessary to install or use Android Studio or Xcode.\n\n### What if I want to write custom native code for my app?\n\nIf you're sure that you need custom native code, please read the [ejecting guide](https://github.com/theTechie/create-react-primitive-app/blob/master/EJECTING.md).\n\n### How do I get my app into the Play Store/App Store?\n\nIf you need to build IPAs and APKs for publishing to the App Store and/or Play Store, you can either eject (see above guide) and build them yourself using Xcode and Android Studio, or you can use a service like [Expo's standalone app builds](https://docs.expo.io/versions/v13.0.0/guides/building-standalone-apps.html) to publish your pure JS app.\n\n## Contributing\n\nContributions will be licensed under the [3-clause BSD license](https://github.com/theTechie/create-react-primitive-app/blob/master/LICENSE). Please fork the repository, perform your work on a feature branch, and submit a pull request to this repository's master branch from your fork's branch.\n\nFor details about setting up a development environment and testing your changes, please see [CONTRIBUTING.md](https://github.com/theTechie/create-react-primitive-app/blob/master/CONTRIBUTING.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthetechie%2Fcreate-react-primitive-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthetechie%2Fcreate-react-primitive-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthetechie%2Fcreate-react-primitive-app/lists"}