create react app
v5.0.1
Cree aplicaciones React sin configuración de compilación.
La aplicación Create React funciona en macOS, Windows y Linux.
Si algo no funciona, presente un problema.
Si tiene preguntas o necesita ayuda, pregunte en Discusiones de GitHub.
npx create-react-app my-app
cd my-app
npm start Si anteriormente instaló create-react-app globalmente a través de npm install -g create-react-app , le recomendamos desinstalar el paquete usando npm uninstall -g create-react-app o yarn global remove create-react-app para garantizar ese npx siempre usa la última versión.
(npx viene con npm 5.2+ y superior; consulte las instrucciones para versiones anteriores de npm)
Luego abra http://localhost:3000/ para ver su aplicación.
Cuando esté listo para implementar en producción, cree un paquete minimizado con npm run build .
No es necesario instalar ni configurar herramientas como webpack o Babel.
Están preconfigurados y ocultos para que puedas centrarte en el código.
Crea un proyecto y listo.
Necesitará tener Node 14.0.0 o una versión posterior en su máquina de desarrollo local (pero no es necesario en el servidor). Recomendamos utilizar la última versión LTS. Puede utilizar nvm (macOS/Linux) o nvm-windows para cambiar las versiones de Node entre diferentes proyectos.
Para crear una nueva aplicación, puede elegir uno de los siguientes métodos:
npx create-react-app my-app(npx es una herramienta de ejecución de paquetes que viene con npm 5.2+ y superior; consulte las instrucciones para versiones anteriores de npm)
npm init react-app my-app npm init <initializer> está disponible en npm 6+
yarn create react-app my-app yarn create <starter-kit-package> está disponible en Yarn 0.25+
Creará un directorio llamado my-app dentro de la carpeta actual.
Dentro de ese directorio, generará la estructura inicial del proyecto e instalará las dependencias transitivas:
my-app
├── README.md
├── node_modules
├── package.json
├── .gitignore
├── public
│ ├── favicon.ico
│ ├── index.html
│ └── manifest.json
└── src
├── App.css
├── App.js
├── App.test.js
├── index.css
├── index.js
├── logo.svg
└── serviceWorker.js
└── setupTests.js
Sin configuración ni estructuras de carpetas complicadas, solo los archivos que necesitas para crear tu aplicación.
Una vez realizada la instalación, puede abrir la carpeta de su proyecto:
cd my-appDentro del proyecto recién creado, puedes ejecutar algunos comandos integrados:
npm start o yarn start Ejecuta la aplicación en modo de desarrollo.
Abra http://localhost:3000 para verlo en el navegador.
La página se recargará automáticamente si realiza cambios en el código.
Verá los errores de compilación y las advertencias de pelusa en la consola.
npm test o yarn test Ejecuta el observador de pruebas en modo interactivo.
De forma predeterminada, ejecuta pruebas relacionadas con archivos modificados desde la última confirmación.
Lea más sobre las pruebas.
npm run build o yarn build Crea la aplicación para producción en la carpeta build .
Incluye correctamente React en modo de producción y optimiza la compilación para obtener el mejor rendimiento.
La compilación se minimiza y los nombres de archivos incluyen los hashes.
Su aplicación está lista para ser implementada.
Puede encontrar instrucciones detalladas sobre el uso de la aplicación Create React y muchos consejos en su documentación.
Consulte la Guía del usuario para obtener esta y otra información.
Una dependencia: solo hay una dependencia de compilación. Utiliza webpack, Babel, ESLint y otros proyectos increíbles, pero además proporciona una experiencia curada y coherente.
No se requiere configuración: no necesita configurar nada. Se maneja una configuración razonablemente buena de las compilaciones de desarrollo y producción para que pueda concentrarse en escribir código.
Sin bloqueo: puede “expulsar” a una configuración personalizada en cualquier momento. Ejecute un solo comando y todas las dependencias de configuración y compilación se trasladarán directamente a su proyecto, para que pueda continuar justo donde lo dejó.
Su entorno tendrá todo lo que necesita para crear una aplicación React moderna de una sola página:
-webkit- ni otros prefijos.[email protected] y superior )Consulte esta guía para obtener una descripción general de cómo encajan estas herramientas.
La desventaja es que estas herramientas están preconfiguradas para funcionar de una manera específica . Si su proyecto necesita más personalización, puede "expulsarlo" y personalizarlo, pero luego deberá mantener esta configuración.
La aplicación Create React es ideal para:
Aquí hay algunos casos comunes en los que quizás quieras probar algo más:
Si desea probar React sin cientos de dependencias de herramientas de compilación transitivas, considere usar un único archivo HTML o una zona de pruebas en línea.
Si necesita integrar el código de React con un marco de plantilla del lado del servidor como Rails, Django o Symfony, o si no está creando una aplicación de una sola página , considere usar nwb o Neutrino, que son más flexibles. Específicamente para Rails, puede usar Rails Webpacker. Para Symfony, pruebe el paquete web Encore de Symfony.
Si necesita publicar un componente de React , nwb también puede hacerlo, así como el ajuste preestablecido de componentes de reacción de Neutrino.
Si desea realizar renderizado en el servidor con React y Node.js, consulte Next.js o Razzle. La aplicación Create React es independiente del backend y solo produce paquetes HTML/JS/CSS estáticos.
Si su sitio web es mayormente estático (por ejemplo, un portafolio o un blog), considere usar Gatsby o Next.js. A diferencia de la aplicación Create React, Gatsby prerenderiza el sitio web en HTML en el momento de la construcción. Next.js admite tanto el renderizado del servidor como el renderizado previo.
Finalmente, si necesita más personalización , consulte Neutrino y su ajuste preestablecido de React.
Todas las herramientas anteriores pueden funcionar con poca o ninguna configuración.
Si prefiere configurar la compilación usted mismo, siga esta guía.
¿Busca algo similar, pero para React Native?
Consulte Expo CLI.
¡Nos encantaría contar con tu ayuda en create-react-app ! Consulte CONTRIBUTING.md para obtener más información sobre lo que estamos buscando y cómo comenzar.
La aplicación Create React es un proyecto mantenido por la comunidad y todos los contribuyentes son voluntarios. Si desea apoyar el desarrollo futuro de la aplicación Create React, considere hacer una donación a nuestro Open Collective.
Este proyecto existe gracias a todas las personas que contribuyen.
Gracias a Netlify por alojar nuestra documentación.
Agradecemos a los autores de proyectos relacionados existentes por sus ideas y colaboración:
La aplicación Create React es un software de código abierto con licencia del MIT. El logotipo de la aplicación Create React tiene una licencia Creative Commons Attribution 4.0 International.
