Configurando tu proyecto React
Creando tu primer proyecto React
Antes de escribir componentes necesitas un proyecto configurado: un servidor de desarrollo, un empaquetador y la estructura de archivos. Hoy la forma recomendada es usar Vite, una herramienta moderna y muy rápida.
Nota
Necesitas tener instalado Node.js (versión 18 o superior). Comprueba tu versión con node -v en la terminal.
Opción recomendada: Vite
Vite crea el proyecto, instala lo mínimo necesario y arranca un servidor con recarga instantánea:
# 1. Crear el proyecto con la plantilla de React
npm create vite@latest mi-app -- --template react
# 2. Entrar a la carpeta
cd mi-app
# 3. Instalar las dependencias
npm install
# 4. Arrancar el servidor de desarrollo
npm run devAl terminar verás una URL como http://localhost:5173. Ábrela en el navegador y tendrás tu aplicación funcionando con recarga en caliente.
Estructura típica del proyecto
mi-app/
├── node_modules/ (dependencias instaladas)
├── public/ (archivos estáticos)
├── src/
│ ├── App.jsx (componente principal)
│ ├── App.css
│ ├── main.jsx (punto de entrada)
│ └── index.css
├── index.html
├── package.json (scripts y dependencias)
└── vite.config.jsLos archivos clave
main.jsx: el punto de entrada
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App'
import './index.css'
ReactDOM.createRoot(document.getElementById('root')).render(
<React.StrictMode>
<App />
</React.StrictMode>
)App.jsx: tu componente principal
function App() {
return (
<div>
<h1>¡Hola, React!</h1>
</div>
)
}
export default App¿Vite o Create React App?
Durante años se usó create-react-app (CRA), pero hoy está prácticamente sin mantenimiento y es notablemente más lento al arrancar y recompilar. Para proyectos nuevos, usa Vite. Verás CRA en proyectos antiguos, pero no es la recomendación actual.
Extensiones útiles para VS Code
- ES7+ React/Redux snippets: atajos como
rafcepara crear componentes al instante. - Prettier: formatea el código automáticamente al guardar.
- ESLint: detecta errores y malas prácticas mientras escribes.
¿Qué comando arranca el servidor de desarrollo en un proyecto creado con Vite?
dev, así que se arranca con npm run dev. npm start es el de Create React App.Ejercicio práctico
Objetivo: crear y arrancar tu propio proyecto React desde cero.
- Crea un proyecto llamado
mi-primer-reactcon Vite. - Instala dependencias y arráncalo con
npm run dev. - Edita
App.jsxpara que muestre tu nombre dentro de un<h1>y guarda: observa la recarga en caliente.
Entregable: una captura de pantalla del navegador mostrando tu nombre y el contenido final de App.jsx.
Para recordar
- Vite es la forma recomendada hoy para crear proyectos React nuevos.
main.jsxes el punto de entrada que monta<App />en el DOM.- El servidor de desarrollo se arranca con
npm run devy ofrece recarga en caliente.