Cómo crear una aplicación React con Vite: guía paso a paso
Guía paso a paso para crear su primera aplicación React con Vite: de la instalación a la configuración, cree una app rápida y eficiente sin complicaciones.
Crear una aplicación React es ahora aún más fácil y rápido gracias a Vite, una herramienta moderna de compilación front-end que presentó en 2020 Evan You, el creador de Vue.js. Vite destaca por su velocidad y eficiencia, y es una excelente alternativa a Create React App (CRA), ya que reduce considerablemente el tiempo necesario para arrancar los servidores de desarrollo y aplicar los cambios en el código. En esta guía repasamos cada paso para configurar una aplicación React con Vite, desde la preparación del entorno hasta el lanzamiento de su primer proyecto.
¿Por qué usar Vite para desarrollar con React?
Vite se ha convertido en una opción popular para proyectos React porque mejora notablemente la velocidad de compilación y la recarga en vivo, lo que hace que el desarrollo sea más rápido y fluido. A diferencia de Create React App (CRA), que a menudo tarda en refrescar el servidor tras modificar un archivo, Vite reduce los tiempos de compilación y ofrece un flujo de trabajo fluido y eficiente. Su diseño modular también beneficia a los desarrolladores de React, ya que muestra antes el efecto de los cambios, algo ideal para quienes necesitan una respuesta inmediata del entorno de desarrollo.
¿Qué es Vite?
Vite, desarrollado por Evan You (el creador de Vue.js), es una herramienta de compilación moderna diseñada para optimizar el desarrollo front-end. El nombre «Vite» procede de la palabra francesa que significa «rápido», en consonancia con su objetivo principal: acelerar el desarrollo y la compilación. Durante el desarrollo, Vite aprovecha los módulos ES nativos del navegador, lo que permite compilaciones más rápidas y tiempos de refresco más cortos que los empaquetadores tradicionales. Esta eficiencia convierte a Vite en una excelente opción para los desarrolladores que quieren agilizar su experiencia de desarrollo con frameworks de JavaScript como React.
Requisitos previos para configurar Vite
Antes de configurar Vite, asegúrese de que su sistema cumple los siguientes requisitos. Son imprescindibles para que la instalación y el desarrollo transcurran sin problemas.
Node.js y npm
Vite depende de Node.js y npm (Node Package Manager) para instalar paquetes y ejecutar los scripts de desarrollo. Para usar Vite necesita Node.js 18.x o posterior y una versión de npm compatible. Así puede comprobar si tiene instaladas las versiones correctas:
Comprobar la versión de Node.js
Abra la terminal y escriba el siguiente comando: bash node -vEste comando devuelve la versión de Node.js instalada, que debe ser 18.x o superior.
Comprobar la versión de npm
A continuación, compruebe la versión de npm ejecutando: bash npm -vEste comando muestra la versión de npm instalada. Si sus versiones están desactualizadas, puede descargar las más recientes de Node.js y npm desde el sitio web oficial de Node.js.
Si Node.js y npm no están instalados, o si necesita actualizarlos, puede instalarlos o actualizarlos a través del repositorio de NodeSource (en Linux) o descargando el instalador directamente desde el sitio web oficial.
Conocimientos básicos de la línea de comandos
Para usar Vite hay que estar familiarizado con las operaciones básicas de la línea de comandos. Durante la configuración ejecutará una serie de comandos en la terminal para crear, instalar y lanzar su proyecto de Vite. Esto es lo que debería dominar:
- Moverse entre directorios: Comandos como cd para cambiar de directorio y ls para listar archivos.
- Ejecutar comandos: Tendrá que ejecutar comandos de npm como npm install y npm run dev.
Editor de código
Se recomienda encarecidamente usar un editor de código, como Visual Studio Code (VS Code), para gestionar y editar los archivos del proyecto. VS Code ofrece varias funciones útiles:
- Resaltado de sintaxis: Hace que el código sea más legible.
- Terminal integrada: Permite ejecutar comandos de terminal directamente desde el editor.
- Extensiones: VS Code dispone de extensiones para JavaScript, React y Vite que ofrecen sugerencias de código, detección de errores y herramientas adicionales.
Configuración de Vite para su proyecto React: requisitos previos y preparación
Antes de empezar a crear su primera aplicación React con Vite, es fundamental asegurarse de que el entorno de desarrollo está bien configurado. Vite es una herramienta de compilación moderna y rápida, diseñada para agilizar el desarrollo front-end, pero necesita versiones de software y herramientas concretas para funcionar correctamente. En esta guía tratamos los requisitos previos: la instalación de las versiones necesarias de Node.js y npm, los conocimientos básicos de la línea de comandos y la configuración de un editor de código adecuado. Una vez que tenga todo esto listo, podrá empezar a crear con Vite aplicaciones React eficientes y de carga rápida.
Paso 1: Instalar Node.js y npm (si no están instalados)
Para usar Vite necesita Node.js 18.x o posterior junto con npm. Si ya tiene Node.js instalado pero la versión está desactualizada, siga estos pasos para eliminar la versión antigua e instalar la más reciente.
Eliminar las versiones existentes de Node.js (opcional)
Si ya tiene instalada una versión antigua de Node.js o npm, elimínela para evitar problemas de compatibilidad. bash sudo apt remove nodejs npmsudo apt autoremove
Este paso elimina cualquier instalación antigua de Node.js o npm y garantiza una configuración limpia para Vite.
Añadir el repositorio de NodeSource
Este repositorio ofrece las versiones más recientes de Node.js y npm para su instalación. bash curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -Instalar Node.js y npm
bash sudo apt install -y nodejs npmAsí se instala la versión actual de Node.js (18.x) y npm, lo que garantiza la compatibilidad con Vite.
Verificar la instalación
Tras la instalación, compruebe que Node.js y npm se han instalado correctamente ejecutando: bash node -vnpm -v
Debería ver los números de versión, que confirman que Node.js y npm están listos para usarse.
Paso 2: Instalar Vite de forma global
Ahora que Node.js y npm están configurados, puede instalar Vite de forma global. Así podrá crear fácilmente nuevos proyectos de Vite desde cualquier directorio.
Ejecutar el comando de instalación global
bash sudo npm install -g create-viteEste comando instala Vite de forma global y proporciona un único comando para inicializar proyectos de Vite rápidamente. Tener Vite instalado globalmente simplifica la creación y configuración de proyectos.
Paso 3: Crear un nuevo proyecto React con Vite
Con Vite instalado, ya puede crear un nuevo proyecto React. Abra la terminal, vaya al directorio que prefiera y utilice el siguiente comando para iniciar la configuración.
Ejecutar el comando de creación de Vite
bash npm create vite@latest my-appSustituya my-app por el nombre que quiera dar a su proyecto. Este comando inicializa un proyecto de Vite, que le guiará a través de varias preguntas de configuración.
Responder a las preguntas de configuración:
- Nombre del proyecto: Elija un nombre para el directorio del proyecto (por ejemplo, "my-app").
- Selección del framework: Seleccione «React» en la lista de frameworks.
- Variante: Elija entre JavaScript y TypeScript según sus preferencias.
Paso 4: Ir a la carpeta del proyecto
Una vez configurado el proyecto, entre en el directorio recién creado para empezar a trabajar con él.
Cambiar al directorio del proyecto
bash cd my-appEste comando cambia el directorio de trabajo a my-app, lo que facilita gestionar los archivos del proyecto de Vite y trabajar con ellos.
Paso 5: Instalar las dependencias del proyecto
Antes de ejecutar el proyecto, instale todas las dependencias necesarias. Se trata de las bibliotecas y paquetes que el proyecto necesita para funcionar.
Ejecutar el comando de instalación
bash npm installEste comando descarga e instala todas las dependencias indicadas en el archivo package.json. Estas dependencias hacen funcionar los componentes de React, las funciones de Vite y cualquier otra herramienta o biblioteca que utilice en su proyecto.
Paso 6: Iniciar el servidor de desarrollo
Ahora que la configuración está completa y las dependencias instaladas, inicie el servidor de desarrollo de Vite. Este servidor le permite ver su aplicación en vivo y aplicar los cambios en el código al instante.
Ejecutar el servidor de desarrollo
bash npm run devEste comando lanza el servidor de desarrollo, y Vite mostrará una URL local desde la que se puede acceder a la aplicación. Por defecto, esta URL es: arduino http://localhost:5173/
Según su versión de Vite, también puede ver opciones de red e información adicional.
Paso 7: Ver su aplicación React en el navegador
Con el servidor de desarrollo en marcha, ya puede ver su aplicación React en un navegador web.
Abrir la URL local en el navegador:
- Abra el navegador web que prefiera.
- Vaya a la URL que aparece en la terminal, normalmente http://localhost:5173/.
Estructura de un proyecto de Vite
Una vez configurado su proyecto de Vite, verá una estructura estándar de carpetas y archivos que organiza los componentes esenciales de su aplicación React. Esta estructura mantiene el proyecto ordenado y modular, para que pueda centrarse en el desarrollo sin perderse en detalles de configuración. A continuación se describen los principales archivos y directorios de una aplicación React típica basada en Vite:
index.html
- Es el archivo HTML principal de la aplicación. Sirve como punto de entrada para que el navegador cargue la aplicación React.
- Vite inyecta aquí los módulos de JavaScript, de modo que la aplicación tiene acceso a los scripts y recursos necesarios.
- A diferencia de las configuraciones tradicionales, el index.html de Vite se encuentra en la raíz del proyecto, lo que simplifica la carga de módulos y mantiene la configuración limpia.
src/main.jsx
- Es el punto de entrada de la aplicación React, donde esta se inicializa.
- En este archivo encontrará el código que renderiza el árbol de componentes de React en el DOM, normalmente vinculando la aplicación a un div raíz de index.html.
- Es el primer archivo JavaScript que Vite procesa y empaqueta, por lo que resulta esencial para la estructura y la secuencia de carga de la aplicación.
src/App.jsx
- Este archivo representa el componente principal de la aplicación React y suele contener su estructura o diseño principal.
- Desde App.jsx puede importar y gestionar otros componentes, definir rutas o crear cualquier otra configuración a nivel de aplicación.
- Modificar App.jsx suele producir los cambios más visibles en la aplicación, ya que normalmente es el corazón de la interfaz de su proyecto.
vite.config.js
- Es el archivo de configuración de Vite, ubicado en la raíz del proyecto.
- Permite personalizar el comportamiento y los ajustes de Vite, por ejemplo, definir opciones de compilación, añadir plugins o configurar un proxy.
- Aunque Vite está pensado para funcionar sin apenas configuración, vite.config.js le da flexibilidad para ajustar los parámetros a medida que crece el proyecto.
Archivos y directorios adicionales
Aunque estos archivos principales son esenciales, a medida que amplíe su proyecto puede encontrarse con otros directorios y archivos, como:
- public/: Una carpeta para guardar recursos estáticos como imágenes, fuentes o iconos. Estos archivos se sirven directamente, sin necesidad de importaciones especiales.
- src/: La carpeta principal para todo el código fuente de la aplicación. Además de main.jsx y App.jsx, contiene otros componentes de React, funciones auxiliares o proveedores de contexto a medida que la aplicación crece.
Ventajas de usar Vite en lugar de Create React App
Pasar de Create React App (CRA) a Vite puede aportar varias ventajas de rendimiento y productividad. Vite está pensado para la velocidad y la eficiencia, y ofrece a los desarrolladores una experiencia de desarrollo más ágil. Veamos con más detalle las ventajas de Vite frente a CRA:
Compilaciones más rápidas
Vite reduce considerablemente los tiempos de compilación porque gestiona los módulos de forma distinta a CRA. Así lo consigue:
- Preempaquetado de módulos: Vite preempaqueta las dependencias con esbuild, un empaquetador rápido optimizado para JavaScript. Este preempaquetado acelera el tiempo de carga inicial al organizar y agrupar las dependencias de forma más eficaz.
- Sintaxis de módulos ES: Durante el desarrollo, Vite utiliza importaciones de módulos ES en el navegador, de modo que solo se cargan los archivos necesarios para la vista actual. Así se evita tener que empaquetar toda la aplicación con cada cambio, lo que acelera el arranque.
- Carga diferida durante el desarrollo: Vite carga los módulos solo cuando se necesitan, lo que reduce la carga de trabajo del servidor de desarrollo y acelera las recargas. A diferencia de CRA, Vite no recompila todo el código tras cada cambio, lo que reduce los tiempos de espera.
Sustitución de módulos en caliente (HMR) eficiente
La sustitución de módulos en caliente (HMR, Hot Module Replacement) es una función que actualiza los módulos en tiempo real a medida que los edita, sin necesidad de recargar toda la página. El sistema HMR de Vite es más eficiente que el de CRA, lo que aporta varias ventajas:
- Recarga selectiva: El sistema HMR de Vite solo actualiza los módulos que cambian, en lugar de recargar toda la aplicación. Por ejemplo, si edita un archivo CSS o un componente, Vite recarga solo ese archivo o módulo concreto.
- Respuesta más rápida a los cambios: Esta recarga selectiva permite a los desarrolladores ver los cambios casi al instante, lo que mejora la productividad y ahorra tiempo.
- Conservación del estado de la aplicación: Como solo se sustituyen los módulos necesarios, el HMR de Vite conserva el estado de la aplicación durante el desarrollo. Esto significa que puede seguir probando sin tener que restablecer datos ni configuraciones.
Experiencia de desarrollo ligera
Vite está diseñado para ofrecer una configuración mínima y optimizada que elimina la complejidad innecesaria, lo que hace más fácil y rápido empezar un proyecto. Estas son las razones por las que Vite ofrece una experiencia más ligera que CRA:
- Configuración mínima: Vite requiere poca o ninguna configuración para empezar, y la mayoría de los ajustes habituales se gestionan automáticamente. CRA a menudo exige configuraciones personalizadas o dependencias adicionales para funciones como la división de código o el empaquetado avanzado, mientras que Vite simplifica este proceso.
- Paquetes más pequeños: El empaquetado optimizado de Vite genera paquetes de producción más pequeños, lo que mejora el rendimiento al desplegar la aplicación.
- Configuración rápida: Configurar un proyecto de Vite es sencillo y rápido. Con solo unos pocos comandos, estará listo para empezar a programar sin los archivos y scripts adicionales que a veces incluye CRA.
- Sistema de plugins flexible: El sistema de plugins de Vite es potente y fácil de usar, y permite añadir funcionalidades sin sobrecargar la configuración. Los plugins de Vite también son compatibles con Rollup, un empaquetador popular, lo que amplía las opciones para personalizar la compilación sin sacrificar velocidad.
Colabore con Mobian para crear su aplicación móvil a medida
Si está pensando en crear una aplicación móvil, Mobian puede ofrecerle apoyo experto durante todo el proceso de desarrollo. Tanto si quiere mejorar la relación con sus clientes, aumentar su fidelidad o crear una experiencia fluida para los usuarios, una aplicación móvil bien diseñada puede ayudarle a lograrlo. Mobian está especializada en crear aplicaciones llave en mano a medida, adaptadas a las necesidades concretas de su negocio.
A través de nuestras aplicaciones, sus clientes pueden consultar noticias y promociones y contratar servicios directamente, mientras usted disfruta de funciones como la recogida sencilla de opiniones, las reseñas y un sistema de pedidos fluido. Nuestra experiencia abarca una amplia variedad de sectores, de MedTech a FinTech, así que, sea cual sea la complejidad o la visión de su aplicación, estamos preparados para hacerla realidad.
Póngase en contacto con Mobian para hablar de su proyecto y descubrir cómo podemos hacer realidad su idea de aplicación. Juntos podemos crear una aplicación que prepare a su empresa para el futuro.
Construyamos juntos el futuro con Mobian, su desarrollador de aplicaciones móviles de confianza.
Conclusión
Siguiendo esta guía, ya ha configurado un entorno de Vite para su proyecto React. Su proceso de compilación ligero y rápido y la sustitución de módulos en caliente (HMR) hacen de Vite una excelente opción para el desarrollo moderno con React, con una experiencia más eficiente que la de herramientas tradicionales como Create React App. Con la arquitectura optimizada de Vite, ya está preparado para crear aplicaciones dinámicas y adaptables, y centrarse en desarrollar funciones en lugar de esperar a que terminen las compilaciones. Siga explorando las opciones de configuración de Vite y sus plugins adicionales para personalizar aún más su entorno de desarrollo. ¡Feliz programación!
Preguntas frecuentes
¿Qué es Vite y por qué debería usarlo en proyectos React?
Vite es una herramienta de compilación moderna creada por Evan You (el desarrollador detrás de Vue.js) centrada en la velocidad y la eficiencia. A diferencia de las herramientas de compilación tradicionales, Vite utiliza módulos ES nativos para reducir los tiempos de carga, lo que resulta especialmente útil para los desarrolladores de React que necesitan ver rápidamente el efecto de sus cambios en el código. Es una gran alternativa a Create React App, sobre todo en proyectos grandes.
¿Qué versiones de Node.js y npm se necesitan para usar Vite?
Vite requiere Node.js 18.x o superior y una versión actualizada de npm compatible con ella. Puede comprobar sus versiones ejecutando node -v y npm -v en la terminal. Si necesita actualizar, visite el sitio web oficial de Node.js para descargar los instaladores más recientes.
¿Puedo usar Vite con TypeScript en lugar de JavaScript?
¡Sí! Vite es compatible con TypeScript desde el primer momento. Durante la configuración inicial puede elegir TypeScript como lenguaje. El proyecto quedará configurado para trabajar con archivos .ts y .tsx, con seguridad de tipos y otras ventajas para el desarrollo.
¿Cómo mejora Vite la velocidad de desarrollo frente a Create React App?
Vite mejora la velocidad principalmente gracias a su eficiente empaquetado de módulos y a la sustitución de módulos en caliente (HMR). Solo recarga los módulos que cambian, en lugar de toda la aplicación, lo que permite actualizaciones más rápidas y un entorno de desarrollo más ágil.
¿Vite solo es compatible con React o puedo usarlo con otros frameworks?
Aunque Vite se usa a menudo con React, es una herramienta versátil compatible con varios frameworks de JavaScript, como Vue, Svelte y Preact. Su arquitectura independiente del framework le permite funcionar como herramienta de compilación rápida para distintas tecnologías front-end.
¿Necesito algún editor de código concreto para trabajar con Vite?
Puede utilizar cualquier editor de código, aunque se recomienda especialmente Visual Studio Code (VS Code). Ofrece un amplio soporte para JavaScript y React, se integra fácilmente con npm e incluye extensiones útiles para proyectos con Vite. Otros editores populares, como Sublime Text y WebStorm, también funcionan bien.