13. Reconociendo carpetas en react

  

Estructura de Carpetas en React - Guía Completa

Hoy vamos a desglosar la estructura de carpetas en un proyecto React y entender para qué sirve cada archivo y directorio. ¡Vamos a organizar nuestro código como profesionales! 🚀

📁 Estructura Básica de un Proyecto React

Carpetas CRÍTICAS (No tocar)

bash
node_modules/    ⚠️  # Dependencias instaladas - NO MODIFICAR

Archivos de Configuración

bash
package.json     📋  # Dependencias y scripts del proyecto
package-lock.json 🔒 # Historial exacto de dependencias
README.md        📚  # Documentación del proyecto

Carpeta Pública

bash
public/
├── index.html   🏠  # ÚNICO HTML - Punto de entrada
└── favicon.ico  🎯  # Ícono del sitio

💡 Importante: En index.html encontramos el div con id="root" que es el contenedor donde React renderiza toda la aplicación.

Carpeta Source (Src) - ¡El Corazón del Proyecto!

bash
src/
├── index.js     ⚡  # Punto de entrada JavaScript
├── App.js       🎨  # Componente principal
├── App.css      🎭  # Estilos del componente App
└── ...          📦  # Tus componentes y archivos

🎯 Explicación Clave de Archivos

1. public/index.html

html
<!DOCTYPE html>
<html>
  <body>
    <div id="root"></div> <!-- ¡Aquí vive React! -->
  </body>
</html>
  • Único archivo HTML de la aplicación

  • React inyecta todo el contenido en el div #root

  • Contiene metadatos, título y enlaces a recursos

2. src/index.js

javascript
import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App';

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<App />);
  • Puerta de entrada de JavaScript

  • Conecta React con el DOM

  • Renderiza el componente principal

3. src/App.js

javascript
import React from 'react';
import './App.css';

function App() {
  return (
    <div className="App">
      <h1>¡Bienvenido a React!</h1>
    </div>
  );
}

export default App;
  • Componente raíz de la aplicación

  • Contiene la estructura principal

  • Importa y organiza otros componentes

🗂️ Estructura Recomendada para Proyectos Reales

bash
src/
├── components/     # Componentes reutilizables
├── pages/         # Componentes de página completa
├── hooks/         # Custom hooks personalizados
├── contexts/      # Context API para estado global
├── services/      # Llamadas a APIs y servicios
├── utils/         # Funciones utilitarias
├── styles/        # Archivos de estilos globales
├── assets/        # Imágenes, fuentes, etc.
└── App.js         # Componente principal

🚀 Buenas Prácticas

  1. Mantén node_modules intacta - Nunca la modifiques manualmente

  2. Organiza por funcionalidad no por tipo de archivo

  3. Usa nombres descriptivos en carpetas y archivos

  4. Componentes en PascalCase - MiComponente.js

  5. Utilidades en camelCase - formatearFecha.js

⚠️ Archivos que Podemos Eliminar Al Inicio

  • src/App.test.js (si no usamos testing)

  • src/reportWebVitals.js

  • src/setupTests.js

  • src/logo.svg

🎬 Comandos Esenciales

bash
# Crear proyecto
npx create-react-app nombre-proyecto

# Iniciar servidor de desarrollo
npm start

# Construir para producción
npm run build

💡 Conclusión

Entender la estructura de carpetas en React es fundamental para:

  • Mantener el código organizado

  • Facilitar el trabajo en equipo

  • Escalar la aplicación fácilmente

  • Encontrar archivos rápidamente

Recuerda: React es una librería, no un framework, por lo que te da libertad para organizar tu proyecto como mejor te parezca. ¡Aprovecha esa flexibilidad! 

Comentarios

Entradas más populares de este blog

11. Creando un proyecto react con create-react-app

29. useEffect

38. 4 Routers