|
3 | 3 | <palign="center"> |
4 | 4 | <ahref="https://github.com/expo/examples"> |
5 | 5 | <img alt="create-react-native-app" src="./.gh-assets/banner.svg"> |
6 | | -<h1 align="center">Create React Native App</h1> |
| 6 | +<h1 align="center">⚠️ Deprecated</h1> |
7 | 7 | </a> |
8 | 8 | </p> |
9 | 9 |
|
10 | 10 | <!-- Header--> |
11 | 11 |
|
12 | 12 | <palign="center"> |
13 | | - <b>The fastest way to create React Native apps</b> |
14 | | - <br /> |
15 | | - |
16 | | - <palign="center"> |
17 | | -<!-- iOS --> |
18 | | -<img alt="Supports Expo iOS" longdesc="Supports Expo iOS" src="https://img.shields.io/badge/iOS-000.svg?style=flat-square&logo=APPLE&labelColor=999999&logoColor=fff" /> |
19 | | -<!-- Android --> |
20 | | -<img alt="Supports Expo Android" longdesc="Supports Expo Android" src="https://img.shields.io/badge/Android-000.svg?style=flat-square&logo=ANDROID&labelColor=A4C639&logoColor=fff" /> |
21 | | -<!-- Web --> |
22 | | -<img alt="Supports Expo Web" longdesc="Supports Expo Web" src="https://img.shields.io/badge/web-000.svg?style=flat-square&logo=GOOGLE-CHROME&labelColor=4285F4&logoColor=fff" /> |
23 | | - </p> |
24 | | - <palign="center"> |
25 | | -<a href="https://packagephobia.now.sh/result?p=create-react-native-app"> |
26 | | - <img alt="the best way to bootstrap a react native app" longdesc="the best way to create a react native app" src="https://flat.badgen.net/packagephobia/install/create-react-native-app" /> |
27 | | -</a> |
28 | | - </p> |
29 | | - |
30 | | -</p> |
31 | | - |
32 | | -<!-- Body--> |
33 | | - |
34 | | -```sh |
35 | | -npx create-react-native-app |
36 | | -``` |
37 | | - |
38 | | -Once you're up and running with Create React Native App, visit[the tutorial on reactnative.dev](https://reactnative.dev/docs/tutorial) and[the tutorial on expo.dev](https://docs.expo.dev/tutorial/introduction/) for more information on building mobile apps with React. |
39 | | - |
40 | | -<palign="center"> |
41 | | - <imgalign="center"alt="Product: demo"src="./.gh-assets/crna.gif" /> |
| 13 | + <b>It's recommended to use a framework to build apps with React Native, <ahref="https://reactnative.dev/docs/environment-setup">learn more</a>.</b> |
42 | 14 | </p> |
43 | 15 |
|
44 | | -##Usage |
45 | | - |
46 | | --`npx create-react-native-app` Create a new native React app. |
47 | | --`npx crna` Alias for`npx create-react-native-app`. |
48 | | --`npm run ios` -- (`npx expo run:ios`) Build the iOS App (requires a MacOS computer). |
49 | | --`npm run android` -- (`npx expo run:android`) Build the Android App. |
50 | | --`npm run web` -- (`npx expo start --web`) Run the website in your browser. |
51 | | - |
52 | | -###Templates |
53 | | - |
54 | | -By default you create a[bare workflow React](https://docs.expo.dev/bare/overview/) project with support for iOS, Android, and web. The project comes preconfigured with support for[Expo Modules](https://docs.expo.dev/modules/overview/), an API writing native modules using Swift and Kotlin, and this also makes it possible to use any library in the[Expo SDK](https://docs.expo.dev/versions/latest/). |
55 | | - |
56 | | -You can opt to use an example project instead by selecting the "Templates from ..." option. Custom templates can be used with`--template <Example Name or GitHub URL>` option. |
57 | | - |
58 | | -- Use an[example](https://github.com/expo/examples):`npx create-react-native-app -t with-typescript` |
59 | | -- Use a custom template:`npx create-react-native-app --template https://github.com/someone/my-react-starter` -- Only works with GitHub repos on the master branch. |
60 | | -- All examples can be modified in the[expo/examples](https://github.com/expo/examples) repo. |
61 | | - |
62 | | -##Sections |
63 | | - |
64 | | --[Usage with Expo Go App](#usage-with-expo-go-app) |
65 | | --[Support and Contact](#support-and-contact) |
66 | | --[FAQs](#faqs) |
67 | | --[Contributing](#contributing) |
68 | | - |
69 | | -##Usage with Expo Go App |
70 | | - |
71 | | -Expo Go enables you to work with all of the[Components and APIs](https://facebook.github.io/react-native/docs/getting-started) in`react-native`, as well as the[JavaScript APIs](https://docs.expo.io/versions/latest) that the are bundled with the Expo app. |
| 16 | +<br /> |
72 | 17 |
|
73 | | -- Download the "Expo Go" app from the Play Store or App Store. |
74 | | -- Start your project with Expo CLI:`npm start` |
75 | | -- Open the project by scanning the QR code in the terminal. |
76 | | - |
77 | | -##Support and Contact |
78 | | - |
79 | | -If you're having issues with Create React Native App, please make sure: |
80 | | - |
81 | | -- The issue is not covered in the[Expo Docs](https://docs.expo.io/versions/latest/) |
82 | | -- There is not already an[open issue](https://github.com/expo/create-react-native-app/issues/) for your particular problem |
83 | | - |
84 | | -If you've checked the documentation and currently open issues, please either[open a new GitHub issue](https://github.com/expo/create-react-native-app/issues/new) or ask a question on[Expo Community Discord](https://chat.expo.dev). |
85 | | - |
86 | | -##Contributing |
87 | | - |
88 | | -Refer to the[Contributing guide](https://github.com/expo/create-react-native-app/blob/main/CONTRIBUTING.md) for more information. |
89 | | - |
90 | | -###Attribution |
91 | | - |
92 | | -The examples feature was inspired by the`templates` system of[create-next-app](https://github.com/zeit/next.js/tree/canary/packages/create-next-app) by the[Vercel](https://vercel.com/) team. |
93 | | - |
94 | | -##Related |
95 | | - |
96 | | -CRNA is focused on being the fastest way to bootstrap a React Native app without worrying about the native platforms or bundlers required for developing and shipping apps. Other tools provide both an init script (which is slower) and a suite of other tools that can be used for interacting with the project. CRNA is meant to be used with any of the following tools: |
97 | | - |
98 | | --[Expo CLI](https://docs.expo.dev/more/expo-cli/) by[Expo team](https://expo.dev) |
99 | | --[Ignite CLI](https://github.com/infinitered/ignite) by[Infinite Red](https://infinite.red/) |
100 | | --[React Native Community CLI](https://github.com/react-native-community/cli) by members of[the React Native community](https://github.com/orgs/react-native-community/people) |
101 | | - |
102 | | -<!-- Footer--> |
103 | | - |
104 | | -##Contributors ✨ |
105 | | - |
106 | | -<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section--> |
107 | | -[](#contributors-) |
108 | | -<!-- ALL-CONTRIBUTORS-BADGE:END--> |
| 18 | +<!-- Body--> |
109 | 19 |
|
110 | | -Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): |
| 20 | +##Deprecated |
111 | 21 |
|
112 | | -<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section--> |
113 | | -<!-- prettier-ignore-start--> |
114 | | -<!-- markdownlint-disable--> |
115 | | -<table> |
116 | | - <tr> |
117 | | -<td align="center"><a href="https://twitter.com/baconbrix"><img src="https://avatars1.githubusercontent.com/u/9664363?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Evan Bacon</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=EvanBacon" title="Code">💻</a> <a href="https://github.com/expo/create-react-native-app/commits?author=EvanBacon" title="Documentation">📖</a> <a href="#design-EvanBacon" title="Design">🎨</a> <a href="#maintenance-EvanBacon" title="Maintenance">🚧</a> <a href="https://github.com/expo/create-react-native-app/pulls?q=is%3Apr+reviewed-by%3AEvanBacon" title="Reviewed Pull Requests">👀</a></td> |
118 | | -<td align="center"><a href="https://expo.dev"><img src="https://avatars2.githubusercontent.com/u/90494?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brent Vatne</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=brentvatne" title="Code">💻</a> <a href="https://github.com/expo/create-react-native-app/commits?author=brentvatne" title="Documentation">📖</a> <a href="https://github.com/expo/create-react-native-app/pulls?q=is%3Apr+reviewed-by%3Abrentvatne" title="Reviewed Pull Requests">👀</a></td> |
119 | | -<td align="center"><a href="http://hamzah"><img src="https://avatars0.githubusercontent.com/u/26879042?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Hamza Halilovic</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=hamzahalilovic" title="Code">💻</a></td> |
120 | | -<td align="center"><a href="https://bycedric.com"><img src="https://avatars2.githubusercontent.com/u/1203991?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Cedric van Putten</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=byCedric" title="Code">💻</a></td> |
121 | | -<td align="center"><a href="https://twitter.com/VilleImmonen"><img src="https://avatars3.githubusercontent.com/u/497214?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ville Immonen</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=fson" title="Code">💻</a> <a href="https://github.com/expo/create-react-native-app/pulls?q=is%3Apr+reviewed-by%3Afson" title="Reviewed Pull Requests">👀</a></td> |
122 | | -<td align="center"><a href="https://github.com/friederbluemle"><img src="https://avatars0.githubusercontent.com/u/743291?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Frieder Bluemle</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=friederbluemle" title="Code">💻</a></td> |
123 | | -<td align="center"><a href="https://github.com/kbrandwijk"><img src="https://avatars.githubusercontent.com/u/852069?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kim Brandwijk</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=kbrandwijk" title="Code">💻</a></td> |
124 | | - </tr> |
125 | | - <tr> |
126 | | -<td align="center"><a href="https://github.com/srkds"><img src="https://avatars.githubusercontent.com/u/61644078?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nirav</b></sub></a><br /><a href="https://github.com/expo/create-react-native-app/commits?author=srkds" title="Code">💻</a></td> |
127 | | - </tr> |
128 | | -</table> |
| 22 | +Create a new Expo project with[create-expo-app](https://github.com/expo/expo/tree/main/packages/create-expo#readme) instead: |
129 | 23 |
|
130 | | -<!-- markdownlint-restore--> |
131 | | -<!-- prettier-ignore-end--> |
| 24 | +```bash |
| 25 | +# Usage for bun, npm, pnpm, and yarn |
| 26 | +$ npm create expo |
| 27 | +$ bun create expo |
| 28 | +$ pnpm create expo |
| 29 | +$ yarn create expo |
132 | 30 |
|
133 | | -<!-- ALL-CONTRIBUTORS-LIST:END--> |
| 31 | +# Output help information with all available options |
| 32 | +$ npx create-expo --help |
| 33 | +``` |
134 | 34 |
|
135 | | -This project follows the[all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! |
| 35 | +<divalign="center"> |
| 36 | + <br /> |
| 37 | + with ❤️ <strong>Expo</strong> |
| 38 | + <br /> |
| 39 | +</div> |