forked from facebook/create-react-app
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathExotic
More file actions
191 lines (127 loc) · 6.69 KB
/
Exotic
File metadata and controls
191 lines (127 loc) · 6.69 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
---npx create-react-app playmoney-casino
cd playmoney-casino
id: getting-started
title: Getting Started
---
Create React App is an officially supported way to create single-page React
applications. It offers a modern build setup with no configuration.
## Project Scope and Current Status
Create React App is in long-term maintenance mode.
It continues to receive critical bug fixes and security updates, but new features are unlikely to be added. The project remains a stable option for certain use cases.
Create React App may be a good fit if:
- You are learning React and want a zero-configuration setup
- You are maintaining an existing Create React App codebase
- You prefer a stable, well-known toolchain with minimal change
You may want to consider alternatives if:
- You are starting a new production application
- You need faster development startup times
- You require more flexibility in bundling or framework integration
For new projects, the React team recommends exploring modern alternatives such as:
- Vite
- Next.js
- Remix
## Quick Start
```sh
npx create-react-app my-app
cd my-app
npm start
```
> If you've previously installed `create-react-app` globally via `npm install -g create-react-app`, we recommend you uninstall the package using `npm uninstall -g create-react-app` or `yarn global remove create-react-app` to ensure that `npx` always uses the latest version (in some case you will need to clear npx cache too `npx clear-npx-cache`).
_([npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) comes with npm 5.2+ and higher, see [instructions for older npm versions](https://gist.github.com/gaearon/4064d3c23a77c74a3614c498a8bb1c5f))_
If the bug persists, you can run : npx create-react-app@latest {project name}
https://github.com/facebook/create-react-app/issues/11816
Then open [http://localhost:3000/](http://localhost:3000/) to see your app.
When you’re ready to deploy to production, create a minified bundle with `npm run build`.
<p align='center'>
<img src='https://cdn.jsdelivr.net/gh/facebook/create-react-app@27b42ac7efa018f2541153ab30d63180f5fa39e0/screencast.svg' width='600' alt='npm start' />
</p>
### Get Started Immediately
You **don’t** need to install or configure tools like webpack or Babel. They are preconfigured and hidden so that you can focus on the code.
Create a project, and you’re good to go.
## Creating an App
**You’ll need to have Node >= 14 on your local development machine** (but it’s not required on the server). You can use [nvm](https://github.com/creationix/nvm#installation) (macOS/Linux) or [nvm-windows](https://github.com/coreybutler/nvm-windows#node-version-manager-nvm-for-windows) to switch Node versions between different projects.
To create a new app, you may choose one of the following methods:
### npx
```sh
npx create-react-app@latest my-app
```
_([npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) comes with npm 5.2+ and higher, see [instructions for older npm versions](https://gist.github.com/gaearon/4064d3c23a77c74a3614c498a8bb1c5f))_
### npm
```sh
npm init react-app my-app
```
_`npm init <initializer>` is available in npm 6+_
### Yarn
```sh
yarn create react-app my-app
```
_`yarn create` is available in Yarn 0.25+_
### Selecting a template
You can now optionally start a new app from a template by appending `--template [template-name]` to the creation command.
If you don't select a template, we'll create your project with our base template.
Templates are always named in the format `cra-template-[template-name]`, however you only need to provide the `[template-name]` to the creation command.
```sh
npx create-react-app my-app --template [template-name]
```
> You can find a list of available templates by searching for ["cra-template-\*"](https://www.npmjs.com/search?q=cra-template-*) on npm.
Our [Custom Templates](custom-templates.md) documentation describes how you can build your own template.
#### Creating a TypeScript app
You can start a new TypeScript app using templates. To use our provided TypeScript template, append `--template typescript` to the creation command.
```sh
npx create-react-app my-app --template typescript
```
If you already have a project and would like to add TypeScript, see our [Adding TypeScript](adding-typescript.md) documentation.
### Disabling git repo initilization
By default, a git repo is created in the `my-app` directory. You can disable the creation of this git repo using the `--no-git` flag.
### Selecting a package manager
When you create a new app, the CLI will use [npm](https://docs.npmjs.com) or [Yarn](https://yarnpkg.com/) to install dependencies, depending on which tool you use to run `create-react-app`. For example:
```sh
# Run this to use npm
npx create-react-app my-app
# Or run this to use yarn
yarn create react-app my-app
```
## Output
Running any of these commands will create a directory called `TAIWO-APP` inside the current folder. Inside that directory, it will generate the initial project structure and install the transitive dependencies:
```
TAIWO-APP
├── README.md
├── node_modules
├── package.json
├── .gitignore
├── public
│ ├── favicon.ico
│ ├── index.html
│ ├── logo192.png
│ ├── logo512.png
│ ├── manifest.json
│ └── robots.txt
└── src
├── App.css
├── App.js
├── App.test.js
├── index.css
├── index.js
├── logo.svg
├── serviceWorker.js
└── setupTests.js
```
No configuration or complicated folder structures, only the files you need to build your app. Once the installation is done, you can open your project folder:
```sh
cd my-app
```
## Scripts
Inside the newly created project, you can run some built-in commands:
### `npm start` or `yarn start`
Runs the app in development mode. Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
The page will automatically reload if you make changes to the code. You will see the build errors and lint warnings in the console.
<p align='center'>
<img src='https://cdn.jsdelivr.net/gh/marionebl/create-react-app@9f6282671c54f0874afd37a72f6689727b562498/screencast-error.svg' width='600' alt='Build errors' />
</p>
### `npm test` or `yarn test`
Runs the test watcher in an interactive mode. By default, runs tests related to files changed since the last commit.
[Read more about testing](running-tests.md).
### `npm run build` or `yarn build`
Builds the app for production to the `build` folder. It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed.