Crear un proyecto
npm create vite@latest mi-app # elige "Vanilla" o un framework, con o sin TypeScript
cd mi-app
npm install
npm run dev # http://localhost:5173
La estructura es simple: un index.html en la raíz (el punto de entrada, que carga tu src/main.js como módulo), la carpeta src y la carpeta public.
Dos modos
En desarrollo (vite), no empaqueta nada: sirve tus archivos como módulos ES y transforma al vuelo solo lo que el navegador pide (TypeScript, JSX, CSS). Por eso arranca en milisegundos, sin importar el tamaño del proyecto. Las dependencias de node_modules sí se preprocesan una vez, para que carguen rápido.
Con HMR (Hot Module Replacement), al guardar un archivo se reemplaza solo ese módulo en el navegador, sin recargar la página ni perder el estado.
En producción (vite build), empaqueta y optimiza: une los módulos en pocos archivos, elimina el código que no se usa (tree shaking), minifica, divide en partes que se cargan cuando hacen falta (por cada import() dinámico) y pone un hash en cada nombre (assets/index-3f9a1c.js). El resultado queda en dist/, listo para cualquier servidor de archivos estáticos.
npm run build # genera dist/
npm run preview # sirve dist/ para probarlo localmente
Importar de todo
Además de JavaScript, Vite entiende otros tipos de archivo en los import:
import "./estilos.css"; // se inyecta en la página
import estilos from "./tarjeta.module.css"; // CSS Modules: clases con nombres únicos
import logo from "./logo.svg"; // la URL final del archivo
import datos from "./datos.json"; // el objeto
import textoPlano from "./aviso.txt?raw"; // el contenido como texto
import Trabajador from "./calculo.js?worker"; // un Web Worker listo para usar
Lo que está en public/ se copia tal cual y se referencia desde la raíz (/favicon.ico), sin pasar por el empaquetador.
Configuración
Vite funciona sin configuración. Cuando hace falta, vite.config.js:
import { defineConfig } from "vite";
export default defineConfig({
server: {
port: 3000,
proxy: { "/api": "http://localhost:8080" }, // redirige las llamadas a tu servidor
},
build: {
sourcemap: true,
},
});
Los plugins agregan soporte para frameworks (React, Vue, Svelte) y para casi cualquier cosa. Vite usa la interfaz de plugins de Rollup, así que hay miles.
Variables de entorno
Los archivos .env, .env.development y .env.production definen variables. Solo las que empiezan con VITE_ llegan al código del navegador, a través de import.meta.env:
# .env
VITE_API_URL=https://api.tienda.com
DB_PASSWORD=no-llega-al-navegador
const api = import.meta.env.VITE_API_URL;
if (import.meta.env.DEV) console.log("modo desarrollo");
El ecosistema
Vite es la base de muchos frameworks: Astro (con el que está hecho este sitio), SvelteKit, Nuxt, Remix, SolidStart y otros. Su ejecutor de pruebas, Vitest, usa la misma configuración. Por debajo, Vite está migrando a Rolldown, un empaquetador escrito en Rust, para que el build sea todavía más rápido.
Resumen
- Un empaquetador traduce y une tu código para el navegador.
- En desarrollo, Vite sirve módulos ES sin empaquetar y actualiza con HMR.
vite buildempaqueta, optimiza, divide y pone hash en los nombres: el resultado va endist/.- Importa CSS, JSON, imágenes, textos y workers;
public/se copia tal cual. - Solo las variables
VITE_llegan al navegador, y todas son públicas.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Del código al sitio publicado
Resuelto
Elige una respuesta en cada pregunta.
¿Por qué el servidor de desarrollo de Vite arranca tan rápido?
¿Qué es el HMR (Hot Module Replacement)?
¿Qué hace
vite build?¿Qué variables de entorno puede ver el código del navegador en Vite?
Ordena la salida: Variables de entorno
Resuelto
Cuatro valores de import.meta.env con el servidor de desarrollo. Ordena lo que aparecería en la consola del navegador.
1// .env2// VITE_API=https://api.tienda.com3// CLAVE_SECRETA=abc1234 5// src/main.js, con el servidor de desarrollo (npm run dev)6console.log(import.meta.env.VITE_API);7console.log(import.meta.env.CLAVE_SECRETA);8console.log(import.meta.env.MODE);9console.log(import.meta.env.DEV);Consola, de arriba abajo
- development
- https://api.tienda.com
- true
- undefined
Solo las variables con el prefijo VITE_ llegan al código del navegador; la clave secreta queda afuera. MODE y DEV los pone Vite: en vite build serían "production" y false.
Detective: Una variable que no llega
Resuelto
La URL de la API está en el .env, pero el código no la ve. Encuentra la línea y elige el arreglo.
Consola
Uncaught TypeError: Failed to construct 'URL': Invalid base URL
at api.js:2:13Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?