Descargar el código de Bolt y correrlo en tu computadora
Paso a paso: descarga o clona tu proyecto de Bolt.new, instala Node.js, configura las variables de entorno, ejecútalo en local y devuelve tus cambios a Bolt.
Read in English →
Para correr un proyecto de Bolt.new en tu computadora, descárgalo (clic en el título del proyecto y luego Download), descomprímelo, instala Node.js, abre una terminal en la carpeta del proyecto y ejecuta npm install && npm run dev. La terminal te muestra una dirección local, normalmente http://localhost:5173 en proyectos con Vite, que abres en el navegador. Si la app necesita claves de Supabase u otros servicios, ponlas antes en un archivo .env.
Más abajo verás qué instalar, si te conviene el ZIP o GitHub, qué hacer con las variables de entorno y la base de datos, los errores típicos del primer arranque y cómo devolver a Bolt lo que cambies en local.
¿Qué necesito instalar?
- Node.js en su versión LTS, desde nodejs.org. Trae
npm, la herramienta que instala los paquetes del proyecto. La documentación de Bolt pide Node.js para correr un proyecto descargado. - Un editor de código, como VS Code, para leer y modificar los archivos.
- Una terminal: Terminal en macOS, PowerShell o Windows Terminal en Windows. La mayoría de los editores traen una.
- Git, solo si eliges el camino de GitHub.
Comprueba la instalación con node -v y npm -v: los dos deben responder con un número de versión.
¿ZIP o GitHub?
| Descarga ZIP | GitHub | |
|---|---|---|
| Preparación | Dos clics | Conectar GitHub una vez y clonar |
| Historial | Ninguno, es una foto del momento | Cada cambio de Bolt queda como un commit |
| Devolver cambios a Bolt | Manual e incómodo | Haces push y Bolt trae los cambios hechos afuera |
| Ideal para | Mirar rápido, un respaldo, entregarlo una vez | Trabajar en local y en Bolt durante meses |
Para algo más que una mirada rápida, usa GitHub. Haz clic en el icono de GitHub arriba a la derecha del proyecto, autoriza la app de Bolt y crea un repositorio (empieza privado, en la rama main). Después clónalo:
git clone https://github.com/<tu-usuario>/<repo>.git
cd <repo>¿Cómo arranco el proyecto?
- Consigue el código: descomprime el ZIP o clona el repositorio.
- Abre una terminal en la carpeta del proyecto, la que tiene el archivo
package.json. - Instala los paquetes con
npm install. La primera vez tarda uno o dos minutos y crea la carpetanode_modules. - Agrega las variables de entorno (siguiente sección); sin ellas la app puede abrir en blanco.
- Levanta el servidor de desarrollo con
npm run dev. - Abre la dirección que aparece. En Vite suele ser
http://localhost:5173; en Next.js,http://localhost:3000.
Si es una app móvil hecha con Expo, el comando suele ser npx expo start, que muestra un código QR para escanear con la app Expo Go en tu teléfono.
¿Y las variables de entorno y la base de datos?
El código del frontend lee su configuración de un archivo .env en la raíz del proyecto. Los archivos que empiezan con punto están ocultos; en el Finder de macOS se ven con Cmd+Shift+. Busca si ya existe antes de crear uno. Si falta o está incompleto, pregúntale a Bolt en modo Plan: List every environment variable the application requires and where each value can be found.
Un proyecto típico con Vite y Supabase necesita algo así:
VITE_SUPABASE_URL=https://<project-ref>.supabase.co
VITE_SUPABASE_ANON_KEY=<clave publishable o anon>Tres cosas a tener presentes:
- Tu app local usa la misma base de datos que la vista previa de Bolt y, muchas veces, que el sitio publicado. Lo que crees o borres en local es real. Trabaja con una cuenta y datos de prueba.
- Las claves secretas no van en este archivo. Los valores de las funciones de servidor (una clave de OpenAI, la clave secreta de Stripe) viven en Secrets dentro de Bolt y los usa el código del servidor, no el navegador. Lo detallamos en variables de entorno en Bolt.
- Nunca subas el
.enva GitHub. Antes del primer push, revisa que aparezca en.gitignore.
Las funciones de servidor siguen corriendo en la nube. Tu frontend local llama a las versiones desplegadas, así que si cambias el código de una función en tu computadora, no tiene efecto hasta que se vuelva a desplegar.
No arranca: errores típicos del primer intento
| Error | Qué significa | Solución |
|---|---|---|
command not found: npm o 'npm' is not recognized | Node.js no está instalado, o abriste la terminal antes de instalarlo | Instala Node.js LTS y abre una terminal nueva |
Cannot find module '...' | No se instalaron los paquetes | Ejecuta npm install |
npm warn EBADENGINE | Un paquete espera otra versión de Node | Usa la versión que pide el proyecto, a veces indicada en engines dentro de package.json |
ERESOLVE unable to resolve dependency tree | Paquetes que no se ponen de acuerdo en versiones | Mira errores de dependencias npm en Bolt |
EADDRINUSE | Otro programa usa el puerto | Detén el otro servidor o deja que Vite elija otro puerto |
Página en blanco y en consola supabaseUrl is required. | Faltan variables de entorno | Completa el .env y reinicia npm run dev |
Reinicia el servidor después de editar el .env: Vite solo lo lee al arrancar.
¿Cómo devuelvo mis cambios a Bolt?
Con GitHub conectado, haz commit y push. Bolt revisa GitHub cada 30 segundos y trae lo que cambió afuera. Dos reglas evitan sustos:
- No edites el mismo proyecto en los dos lados a la vez. La documentación de Bolt advierte que si Bolt y GitHub cambian casi al mismo tiempo, Bolt conserva su versión y pisa la de GitHub.
- Usa una rama para el trabajo grande en local. Bolt puede cambiar de rama desde el menú de GitHub, pero la fusión (merge) se hace en GitHub, no dentro de Bolt.
Con el ZIP no hay camino automático de vuelta. Bolt documenta una restauración manual a través de StackBlitz que crea un proyecto nuevo con tus archivos: sirve para una mudanza puntual, no para el día a día.
¿Vale la pena tenerlo en local?
Casi siempre, cuando la app ya importa. En local puedes compilar la versión de producción (npm run build) antes de publicar, usar un depurador, agregar pruebas automáticas y dejar que un desarrollador revise el código sin compartir pantalla. También es el paso lógico cuando el proyecto ya no cabe en el contexto de Bolt, como contamos en límite de tokens en Bolt. Y si vas a pasarle el proyecto a otra persona, entregar un proyecto hecho con IA a un desarrollador explica qué incluir.
Respuestas rápidas
¿Descargar el proyecto cambia algo en Bolt? No. Es una copia; el proyecto en Bolt sigue igual.
¿Tengo que saber programar? Para arrancarlo, no: bastan dos comandos. Para modificarlo con seguridad ayuda tener algo de práctica, o un editor con IA trabajando sobre los archivos locales.
¿Puedo seguir usando Bolt después? Sí. Con GitHub en el medio puedes alternar entre Bolt y tu editor.
¿Por qué la app local muestra datos reales de clientes? Porque apunta a la misma base. Si eso es un problema, haz que tu .env local apunte a una base de prueba aparte.
¿Quieres que un desarrollador siga desde aquí?
Si prefieres que alguien deje armado un flujo de trabajo en local y en un entorno de pruebas, nuestros servicios para arreglar apps de Bolt y de desarrollo de software a medida parten de tu repositorio de GitHub. Antes, pasa tu app por la revisión gratuita o escríbenos.
