¿Cómo instalar SvelteKit en Saplo (aplicación ligera con SSR)?

SvelteKit es diferente de React y Vue a nivel de compilador: los componentes se convierten en JavaScript puro en el momento de la compilación, sin DOM virtual cargado en el navegador. El efecto es un paquete más pequeño y un inicio más rápido, especialmente perceptible en teléfonos más lentos y conexiones de menor velocidad. Con el adaptador Node, SvelteKit funciona como SSR, un proceso de larga duración análogo a Next.js o Nuxt, no solo un directorio con archivos estáticos. En Saplo, ejecutas SvelteKit como un servicio administrado con reinicio automático.

Para quién es SvelteKit en Saplo

Antes de comenzar la instalación, verifica si es la opción adecuada para tu proyecto:

• Aplicaciones donde el tamaño del bundle importa - menos JavaScript para descargar y analizar que en una aplicación React o Vue comparable.
• Páginas con interacción real, no solo contenido - SvelteKit funciona bien tanto para páginas sencillas como para aplicaciones complejas.
• Proyectos dirigidos a conexiones más lentas y teléfonos - un bundle más pequeño reduce el tiempo de interacción.
• Quieres despliegues con git push en lugar de la configuración manual del proceso Node - conectas el repositorio una vez y Saplo construye y reinicia el servicio automáticamente.

¿Solo necesitas un SPA ligero sin SSR? Consulta el Catálogo de aplicaciones para ver el stack Svelte por separado (Vite, sin proceso en segundo plano) - es una variante diferente a SvelteKit descrita en este tutorial.

Requisitos

Para instalar SvelteKit en Saplo, necesitas:

• Un Box en el plan L o superior - el adaptador de Node mantiene el proceso constantemente en la memoria, SSR necesita más RAM que una página estática normal.
• Mínimo 512 MB de RAM libre y 3 GB de espacio en disco solo para el proceso de la aplicación.
• Un dominio o subdominio *.saploapp.pl incluido en el precio de cada plan.
• Un repositorio Git, si quieres usar la implementación automática (opcional al principio, también puedes subir la aplicación como archivo .zip a través del panel).

Instalación paso a paso

1. En el panel de control de Saplo, ve a Catálogo de aplicaciones y elige SvelteKit (categoría "Aplicaciones").
2. Selecciona un Box del plan L o superior y el nombre de la aplicación; a partir de este, se creará un subdominio por defecto.
3. Elige la versión de Node.js para la compilación (18, 20 o 22, por defecto 20) y confirma la instalación.
4. El motor crea un proyecto SvelteKit mínimo, instala y reemplaza el adapter-auto por @sveltejs/adapter-node en svelte.config.js, construye el proyecto en el directorio build/ y lo ejecuta a través del supervisor en el puerto 3000. Nginx, a su vez, proxy el tráfico del dominio a ese puerto.
5. Una vez finalizada la instalación, el dominio del paso 2 mostrará la página de inicio de SvelteKit. A partir de este momento, puedes desplegar tu propio código en ella.

Despliegue de tu propio código a través de Git

1. En los detalles de la aplicación, busca la sección Git / CI-CD y haz clic en "Conectar GitHub", confirma la instalación de la aplicación "Saplo Deploy" e indica el repositorio con el proyecto SvelteKit.
2. Asegúrate de que el proyecto tenga @sveltejs/adapter-node instalado en svelte.config.js; sin él, la compilación generará una versión para otro entorno, no para un proceso de Node de larga ejecución.
3. Coloca el archivo saplo.yaml en el directorio raíz del repositorio y envíalo a la rama de producción (por defecto main).
4. Cada git push posterior a esa rama activa la compilación y el reinicio del servicio; el estado lo puedes ver en la pestaña Despliegues.
5. La compilación crea un directorio build/ con un servidor Node, que Saplo ejecuta como un servicio administrado.

Ejemplo de un archivo saplo.yaml mínimo para SvelteKit:

name: my-project
stack: sveltekit
runtime:
  node: "22"
build:
  install: npm ci
  command: npm run build
start:
  command: node build
  port: 3000

SvelteKit en Saplo vs. otras alternativas

Preguntas frecuentes

¿En qué se diferencia SvelteKit de la pila Svelte habitual del catálogo? SvelteKit con el adaptador Node es SSR, un proceso de larga duración. La pila Svelte es una SPA pura construida por Vite, sin proceso en segundo plano, más ligera de mantener, pero sin renderizado del lado del servidor.

¿Necesito reemplazar manualmente el adaptador por Node en mi propio proyecto? Si tu proyecto tiene el adapter-auto predeterminado, cámbialo a @sveltejs/adapter-node antes del primer despliegue a través de Git; de lo contrario, la compilación generará una versión para otro entorno.

¿Cuánta RAM necesita SvelteKit en la práctica? El manifiesto de la receta especifica un mínimo de 512 MB, pero bajo tráfico de producción real, es mejor planificar un Box L (139 € al año) para que el proceso SSR tenga una reserva para los picos de carga.

¿Qué sucede si la compilación falla? La versión anterior en funcionamiento de la aplicación permanece en su lugar, Saplo no la reemplaza por una rota.

¿Obtendré SSL y mi propio dominio? Sí, el certificado SSL es automático y tienes un Dominio o subdominio *.saploapp.pl incluido en el precio de cada plan.

Con SvelteKit en Saplo, pasas de cero a un dominio funcional en cuestión de minutos, y cada git push subsiguiente reinicia el servicio con una nueva versión sin tu intervención. Si tu proyecto no necesita SSR, consulta la pila Svelte, más ligera, en el mismo catálogo.