Desplegar un sitio estático SvelteKit: la ruta del adaptador estático

Si buscaste deploy a SvelteKit static site, quieres el camino más corto y fiable desde código funcional hasta una URL pública — sin montar servidores, sin aprender un panel cloud interminable 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 los compromisos y cuándo otra herramienta es genuinamente la mejor opción. Seremos prácticos: pasos reales, comandos reales y limitaciones honestas.

Requisitos previos

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

Si tu proyecto ya funciona localmente y produce una carpeta de compilación, tienes todo lo necesario.

Compilar un bundle estático

La idea clave detrás de deploy a SvelteKit static site es que tu framework se compila a HTML, CSS y JavaScript planos. Ejecuta tu compilación de producción (npm run build en la mayoría de configuraciones) y confirma que aparece una carpeta de salida. Ábrela localmente con npx serve dist (ajusta el nombre de la carpeta) para verificar que funciona antes de subir nada.

Desplegar en cuatro pasos

1. Compilar: npm run build
2. Registrarse: crear una cuenta gratuita
3. Subir: arrastra la carpeta de salida al panel de jsdeck, o ejecuta jsdeck deploy
4. Verificar: abre tu URL *.jsdeck.com y prueba la navegación, enlaces profundos y actualización

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; de lo contrario, una actualización en un enlace profundo devuelve 404. jsdeck aplica fallback SPA automáticamente para apps alojadas, así que React Router, Vue Router y similares funcionan sin configuración extra. (Para la mecánica subyacente, consulta nuestras guías de corrección de enrutamiento en el hub.)

Dominio personalizado, HTTPS y persistencia

HTTPS se provisiona automáticamente para subdominios de 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 problemas en el 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 actualizar 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 una compilación nueva más un hard refresh lo resuelve.
• Advertencias de contenido mixto: haz que cada petición use HTTPS; jsdeck sirve tu app por HTTPS, así que cualquier recurso http:// será bloqueado por el navegador.

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

A quién va dirigido 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 en el servidor en tiempo de petición, backends WebSocket, secretos privados en el 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 gratuito deploy a SvelteKit static site?

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.

¿Tengo que conectar un repositorio Git?

No. Puedes subir tu carpeta de compilación 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 actualizar?

No. jsdeck aplica fallback SPA para que los enlaces profundos y las actualizaciones 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 detalles de despliegue por CLI