Despliega una app estática desde la CLI: lanzamientos rápidos y repetibles

Si buscaste deploy a static app from the CLI, quieres el camino más corto y fiable del código funcionando a una URL pública — sin montar servidores, aprender un panel cloud complejo ni introducir una tarjeta de crédito antes de tener un solo usuario. Esta guía explica exactamente cómo hacerlo con jsdeck, cuáles son las compensaciones y cuándo otra herramienta es genuinamente la mejor opción. Seremos prácticos: pasos reales, comandos reales y advertencias honestas.

Requisitos previos

• Node.js instalado (o el SDK relevante para tu framework)
• Un proyecto que compile a archivos estáticos (habitualmente dist/, build/ u out/)
• Una cuenta jsdeck gratuita — sin tarjeta de crédito

Si tu proyecto ya funciona en local y genera una carpeta de build, tienes todo lo necesario.

Compilar un paquete estático

La idea clave del deploy a static app from the CLI es que tu framework compila a HTML, CSS y JavaScript planos. Ejecuta tu build de producción (npm run build en la mayoría de configuraciones) y confirma que aparece una carpeta de salida. Ábrela en local con npx serve dist (ajusta el nombre de la carpeta) para verificar que funciona antes de subir nada.

Desplegar en cuatro pasos

1. Build: npm run build
2. Registro: crea una cuenta gratuita
3. Subida: arrastra la carpeta de salida al panel de jsdeck, o ejecuta jsdeck deploy
4. Verificación: abre tu URL *.jsdeck.com y prueba navegación, enlaces profundos y recarga

Enrutamiento del lado del cliente en hosts estáticos

Si tu app usa un router del lado del cliente, las rutas desconocidas deben reescribirse a index.html; si no, una recarga en un enlace profundo devuelve 404. jsdeck aplica fallback SPA automáticamente en apps alojadas, así que React Router, Vue Router y similares funcionan sin configuración extra. (Para los detalles internos, consulta nuestras guías de corrección de enrutamiento en el hub.)

Dominio personalizado, HTTPS y persistencia

HTTPS se provisiona automáticamente para subdominios jsdeck. Cuando estés listo para producción, añade un dominio personalizado desde el panel de la app. Si tu app necesita almacenar algo, activa el datastore en lugar de depender solo del almacenamiento del navegador para que los datos persistan entre dispositivos y sesiones.

Solución de problemas en un despliegue estático

La mayoría de los problemas del primer despliegue provienen de un puñado de causas. Revísalas en orden:

• Página en blanco tras el despliegue: suele ser un problema de rutas de assets. Si tu bundler emite rutas absolutas (/assets/...) pero espera un subpath, configura el base correcto en tu build y recompila.
• 404 al recargar un enlace profundo: es el caso de fallback SPA descrito arriba — confirma que tu router usa modo history y confía en la reescritura automática de jsdeck.
• Sigue mostrándose la versión antigua: un asset en caché. Los bundlers añaden hashes de contenido a los nombres de archivo, así que un build nuevo más recarga forzada lo resuelve.
• Advertencias de mixed content: haz que todas las peticiones usen HTTPS; jsdeck sirve tu app por HTTPS, así que cualquier recurso http:// será bloqueado por el navegador.

Verificar esto en local con npm run preview antes de subir ahorra casi siempre una ida y vuelta.

Para quién es y cuándo no usar jsdeck

Buen encaje: frontends estáticos, single-page apps, demos, portfolios, MVPs, exportaciones generadas por IA y apps que necesitan un poco de persistencia JSON o inicio de sesión ligero para visitantes.

No encaja: apps que requieren un servidor Node en ejecución continua, renderizado del lado del servidor en tiempo de petición, backends WebSocket, secretos privados del lado del servidor, trabajos en segundo plano o una base de datos relacional completa. Para eso, una plataforma como las alternativas del hub de comparativas te servirá mejor — y eso es elegir con criterio, no un compromiso.

Preguntas frecuentes

¿Es realmente gratis deploy a static app from the CLI?

Sí. jsdeck ofrece hosting estático gratuito con HTTPS para proyectos como este, sin tarjeta de crédito para empezar. Funciones opcionales como el datastore y visitor auth están disponibles cuando las necesites.

¿Necesito conectar un repositorio Git?

No. Puedes subir tu carpeta de build directamente en el panel, o desplegar desde la línea de comandos con jsdeck deploy. Git es opcional.

¿Se romperán las rutas del lado del cliente al recargar?

No. jsdeck aplica fallback SPA para que los enlaces profundos y las recargas resuelvan a tu app en lugar de devolver un 404.

Próximos pasos

• Explora más guías en el hub de hosting de apps estáticas
• Sigue la guía de primeros pasos para desplegar tu primera app
• Lee la documentación para desarrolladores sobre datastore, cuentas seguras (auth API) y despliegue por CLI