Crear una app de React de forma manual sin create react app ni Vite es una excelente manera de entender los bloques de construcción reales de un proyecto moderno. En esta guía en español te explico cómo montarlo desde cero, qué papel cumplen Webpack y Babel, y por qué este enfoque te da control total para construir aplicaciones a medida y software a medida listas para producción.
Paso 1. Inicializa el proyecto Crea una carpeta para tu app, entra en ella y ejecuta npm init -y para generar package.json con valores por defecto. Esto te permitirá registrar dependencias, scripts y metadatos del proyecto.
Paso 2. Instala React y ReactDOM Añade react para definir componentes, estado y hooks, y react dom para renderizar esos componentes en el navegador. Con esto podrás montar tu App sobre un elemento del DOM con un id específico.
Importante. Los navegadores no entienden JSX directamente Por eso necesitas un proceso de construcción que convierta JSX y funcionalidades modernas de JavaScript en código compatible con la mayoría de navegadores. Aquí entran en juego dos piezas clave.
Webpack como empaquetador Reúne todos tus módulos JavaScript, estilos y recursos en uno o varios bundles optimizados, aplica loaders para transformar archivos y genera una salida lista para el navegador. Permite dividir código, hacer cache busting y gestionar assets.
Babel como transpilador Transforma código ES6 en adelante y JSX a JavaScript que los navegadores entienden. Con presets adecuados podrás usar sintaxis moderna, clases, async await y mucho más sin perder compatibilidad.
Estructura mínima recomendada Una carpeta public con un index.html que contenga un contenedor con id root y una carpeta src con un archivo principal que cree la raíz de React y renderice el componente App. Puedes añadir una hoja de estilos base y una carpeta para componentes, hooks y utilidades.
Configuración de Babel Utiliza presets para entorno moderno y para React, de modo que puedas escribir JSX y características avanzadas del lenguaje. Añade plugins si necesitas propuestas específicas o compatibilidad adicional, siempre alineado con tu matriz de navegadores objetivo.
Configuración de Webpack Define un punto de entrada en src, una salida en una carpeta dist, reglas de módulo con babel loader para archivos js o jsx, y loaders para css e imágenes si corresponde. Usa HtmlWebpackPlugin para inyectar el bundle en tu plantilla de HTML, activa source maps en desarrollo, especifica modo development o production y, si lo deseas, configura un servidor de desarrollo con recarga en caliente e historia para rutas del lado del cliente.
Scripts de NPM Añade comandos como start para levantar el servidor de desarrollo, build para generar la versión optimizada y serve o preview para revisar la compilación final. Así podrás iterar rápido en desarrollo y publicar builds consistentes en producción.
Verificación y ejecución Con las dependencias instaladas y la configuración lista, ejecuta el script de desarrollo y abre la aplicación en el navegador. Cuando todo funcione, genera el build de producción y comprueba que el artefacto en dist se carga correctamente.
Ventajas de este enfoque Comprendes qué ocurre bajo el capó, mejoras tu capacidad para depurar y optimizar, y dispones de libertad total para escoger loaders, plugins, división de código, reglas de linting, pruebas, integración continua y despliegues. Es un aprendizaje valioso incluso si luego decides volver a herramientas como create react app o Vite.
Buenas prácticas y extras Añade variables de entorno con plugins adecuados, define una política de navegadores con browserslist, integra ESLint y Prettier para mantener un código consistente, prueba con Jest y React Testing Library, considera code splitting por rutas y componentes, y activa caché persistente del compilador y minificación de CSS y JS en producción.
Q2BSTUDIO, tu socio tecnológico En Q2BSTUDIO desarrollamos aplicaciones a medida y software a medida con arquitecturas modernas, aplicamos inteligencia artificial y agentes IA en productos reales, reforzamos ciberseguridad con auditorías y pentesting, y desplegamos soluciones escalables en servicios cloud aws y azure. Si buscas un equipo que diseñe y construya tu plataforma de forma integral, con enfoque en rendimiento, seguridad y escalabilidad, visita nuestra página de desarrollo de aplicaciones y software multiplataforma para conocer cómo trabajamos y por qué somos el partner ideal.
Servicios complementarios También impulsamos servicios inteligencia de negocio con power bi, automatización de procesos, y soluciones de ia para empresas que aceleran la toma de decisiones. Si planeas desplegar tu front end y backend en la nube, descubre cómo optimizamos costes y fiabilidad en servicios cloud aws y azure.
Recurso de apoyo Si quieres ver una referencia de proyecto similar, puedes revisar el repositorio público manualreact en GitHub, donde encontrarás una estructura con HTML base, punto de entrada, configuración de Webpack y Babel, así como scripts para desarrollo y build.
Conclusión Montar React sin create react app ni Vite te da control, te obliga a comprender el pipeline de construcción y te prepara para optimizaciones avanzadas. Es un paso clave para equipos que construyen productos críticos, desde portales web y paneles de control con power bi hasta plataformas con agentes IA y módulos de ciberseguridad integrados.