Comment déployer SvelteKit sur Saplo (application légère avec SSR)

SvelteKit est différent de React et Vue au niveau du compilateur - les composants sont transformés en JavaScript pur au moment de la compilation, sans DOM virtuel chargé dans le navigateur. Le résultat est un bundle plus petit et un démarrage plus rapide, particulièrement perceptible sur les téléphones plus faibles et les connexions plus lentes. Avec l'adaptateur Node, SvelteKit fonctionne comme un SSR - un processus de longue durée similaire à Next.js ou Nuxt, pas seulement un répertoire avec des fichiers statiques. Sur Saplo, tu exécutes SvelteKit en tant que service géré avec redémarrage automatique.

À qui s'adresse SvelteKit sur Saplo

Avant de commencer l'installation, vérifie si c'est le bon choix pour ton projet :

• Application où le poids du bundle compte - Moins de JavaScript à télécharger et à analyser qu'avec une application React ou Vue comparable.
• Site avec une réelle interactivité, pas seulement du contenu - SvelteKit fonctionne aussi bien pour les sites simples que pour les applications complexes.
• Projet ciblant les connexions faibles et les téléphones - Un bundle plus petit réduit le temps d'interactivité.
• Tu veux des déploiements avec git push au lieu d'une configuration manuelle du processus Node - Tu connectes le dépôt une fois, et Saplo construit et redémarre le service automatiquement.

Tu as seulement besoin d'une SPA légère sans SSR ? Consulte le catalogue d'applications pour le stack Svelte (Vite, sans processus en arrière-plan) - c'est une variante différente de SvelteKit décrite dans ce tutoriel.

Exigences

Pour installer SvelteKit sur Saplo, tu as besoin de :

• Une Box de plan L ou supérieur - l'adaptateur Node maintient le processus constamment en mémoire, le SSR nécessite plus de RAM qu'un site statique ordinaire.
• Au minimum 512 Mo de RAM libre et 3 Go d'espace disque pour le processus de l'application.
• Un Domaine ou un sous-domaine *.saploapp.pl inclus dans le prix de chaque plan.
• Un dépôt Git, si tu souhaites utiliser le déploiement automatique (facultatif au début, tu peux aussi télécharger l'application via une archive .zip depuis le Panneau).

Installation étape par étape

1. Dans le Panneau Saplo, va dans le Catalogue d'applications et choisis SvelteKit (catégorie "Applications").
2. Indique une Box du plan L ou supérieur et le nom de l'application - cela créera le sous-domaine par défaut.
3. Choisis la version de Node.js pour le build (18, 20 ou 22, 20 par défaut) et confirme l'installation.
4. Le moteur initialise un projet SvelteKit minimal, installe et remplace le adapter-auto par défaut par @sveltejs/adapter-node dans svelte.config.js, construit le projet dans le répertoire build/ et le lance via supervisor sur le port 3000, tandis que Nginx proxyfie le trafic du domaine vers ce port.
5. Une fois l'installation terminée, le domaine de l'étape 2 affiche la page d'accueil de SvelteKit - à partir de ce moment, tu peux y déployer ton propre code.

Déployer votre propre code avec Git

1. Dans les détails de l'application, trouve la section Git / CI-CD et clique sur « Connecter GitHub ». Confirme l'installation de l'application « Saplo Deploy » et indique le dépôt avec le projet SvelteKit.
2. Assure-toi que le projet a @sveltejs/adapter-node installé dans svelte.config.js - sans cela, le build générera une version pour un autre environnement, et non pour un processus Node de longue durée.
3. Dans le répertoire racine du dépôt, place le fichier saplo.yaml et pousse-le sur la branche de production (par défaut main).
4. Chaque git push ultérieur sur cette branche lance un build et redémarre le service. Tu peux voir le statut dans l'onglet Déploiements.
5. Le build crée un répertoire build/ avec le serveur Node, que Saplo démarre en tant que service géré.

Exemple de fichier saplo.yaml minimal pour SvelteKit :

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

SvelteKit sur Saplo face aux alternatives

Foire aux questions

Quelle est la différence entre SvelteKit et un stack Svelte classique dans le catalogue ? SvelteKit avec un adaptateur Node est un processus SSR qui s'exécute longtemps. Le stack Svelte est un SPA pur, construit par Vite, sans processus d'arrière-plan, plus léger à maintenir, mais sans rendu côté serveur.

Dois-je remplacer manuellement l'adaptateur par Node dans mon propre projet ? Si ton projet a l'adaptateur par défaut adapter-auto, remplace-le par @sveltejs/adapter-node avant le premier déploiement via git - sinon la version générée sera pour un autre environnement.

De combien de RAM SvelteKit a-t-il besoin en pratique ? Le manifeste de la recette indique un minimum de 512 Mo, mais pour un trafic de production réel, il est préférable de prévoir une Box L, afin que le processus SSR dispose d'une marge pour les pics de charge.

Que se passe-t-il si la compilation échoue ? La version précédente et fonctionnelle de l'application reste en place, Saplo ne la remplace pas par une version défectueuse.

Vais-je obtenir un SSL et mon propre Domaine ? Oui, le certificat SSL est automatique, et le Domaine ou sous-Domaine *.saploapp.pl est inclus dans le Prix de chaque plan.

Tu peux installer SvelteKit sur Saplo en quelques minutes, et chaque git push redémarre le service avec la nouvelle version sans ton intervention. Si ton projet n'a pas besoin de SSR, consulte le stack Svelte, plus léger, dans le même catalogue.