SvelteKit 3 : #lib remplace $lib, la config va à Vite

Ce qui se passe

L'équipe Svelte publie SvelteKit 3.0 et le décrit comme le même framework, mieux typé et débarrassé de quelques scories. Une version majeure apporte pourtant ses ruptures, et deux d'entre elles concernent presque tout le monde.

Ce qui change

• La configuration quitte svelte.config.js pour vite.config.ts.
• L'alias $lib devient #lib. Le dièse est celui des subpath imports de Node, déclarés dans le champ imports du package.json : l'alias s'appuie sur un mécanisme standard plutôt que sur une convention de SvelteKit.
• Les variables d'environnement gagnent en souplesse, les service workers demandent moins de code, la gestion des erreurs est revue.

Le détail des ruptures est dans le guide de migration.

Ce qui n'est pas là

Les remote functions, ces appels client-serveur typés, ne sont pas prêtes. Elles reposent sur Async Svelte, qui exige encore un drapeau expérimental. L'équipe en fait sa priorité, sans date.

Comment s'y prendre

npx sv migrate sveltekit-3 --tasks all --confirm

La commande réécrit ce qu'elle peut et dresse la liste du reste. À lancer sur une branche dédiée, puis lire la liste jusqu'au bout et chercher les $lib qui auraient échappé à la réécriture. Pour un nouveau projet : npx sv create.

Source : SvelteKit 3 is here, svelte.dev, 1er octobre 2026.