SvelteKit und serverseitiges Rendering: So arbeitet das Framework

Routing, load-Funktionen, Form Actions und Adapter: was SvelteKit zu Svelte hinzufügt und für welche Webprojekte es sich eignet
Aktualisiert:
Abstract
- #SvelteKit
- #Webentwicklung
- #JavaScript
- #Framework
- #Serverseitiges Rendering
- #Svelte
- #TypeScript
Svelte erzeugt schlanke Komponenten. SvelteKit entscheidet, wo und wann daraus HTML wird.
Ein Kunde öffnet auf dem Smartphone die Produktseite eines Onlineshops, im Zug, mit schwankendem Netz. Ob er nach einer Sekunde den Preis sieht oder nach fünf Sekunden noch auf einen weißen Bildschirm starrt, hängt weniger vom Server ab als von einer Architekturentscheidung: Entsteht die Seite im Browser oder kommt sie fertig vom Server?
SvelteKit ist ein Framework, das diese Entscheidung pro Seite treffen lässt. Es baut auf Svelte auf, einem Werkzeug für Benutzeroberflächen, das Komponenten bereits beim Build in schlanken JavaScript-Code übersetzt. Svelte allein liefert Komponenten. SvelteKit ergänzt alles, was eine vollständige Webanwendung braucht: Routing, Datenabruf, Formularverarbeitung, Serverlogik und den Build für verschiedene Zielplattformen. Wie Svelte als Compiler funktioniert, erklärt der Beitrag Svelte erklärt: Was das Compiler-Framework anders macht. Hier geht es um die Ebene darüber.
Was SvelteKit zu Svelte hinzufügt
Fachleute nennen Werkzeuge wie SvelteKit ein Metaframework: Es erweitert ein Komponenten-Framework zu einer Anwendungsplattform. Für React übernimmt Next.js diese Rolle, für Vue ist es Nuxt. Die Grundidee ist überall ähnlich, die Umsetzung unterscheidet sich im Detail.
SvelteKit wurde vom Svelte-Team um Rich Harris entwickelt. Version 1.0 erschien im Dezember 2022, Version 2 im Dezember 2023, Version 3 im Oktober 2026. Mit Svelte 5, das im Oktober 2024 veröffentlicht wurde, kam ein neues Reaktivitätsmodell hinzu, die sogenannten Runes. Das sind Kennzeichnungen wie $state oder $props, mit denen Komponenten ausdrücklich angeben, welche Werte sich ändern können. Seit SvelteKit 3 ist Svelte 5 Voraussetzung, ältere Komponenten im bisherigen Stil laufen unter Svelte 5 weiterhin.
Ein neues Projekt legt das Kommandozeilenwerkzeug sv an, derzeit mit npx sv create mein-projekt. Es fragt nach TypeScript, Tests und Werkzeugen wie ESLint oder Tailwind CSS. Als Entwicklungsserver und Build-Werkzeug dient Vite, das Änderungen im Code fast sofort im Browser sichtbar macht.
Routing über Ordner und Dateien
In SvelteKit bestimmen Ordner unter src/routes/ die Adressen der Anwendung. Jeder Ordner ist ein URL-Abschnitt, und die Dateien darin haben feste Rollen. Das Pluszeichen am Anfang kennzeichnet Dateien, die SvelteKit selbst auswertet:
src/routes/
├── +layout.svelte # Rahmen für alle Seiten, etwa Navigation
├── +page.svelte # Startseite → /
├── kontakt/
│ ├── +page.svelte # Formular → /kontakt
│ └── +page.server.ts # Formularverarbeitung, nur auf dem Server
└── produkte/
└── [id]/
├── +page.svelte # Produktseite → /produkte/42
└── +page.server.ts # lädt die Daten zum Produkt
Eckige Klammern markieren einen Parameter. Angenommen, ein Händler für Bürobedarf hat 2.000 Artikel: Eine einzige Seite unter produkte/[id] deckt alle ab, die Artikelnummer kommt aus der URL. Layouts gelten für alle Seiten darunter und können verschachtelt werden. Ein Kundenbereich unter konto/ erhält so eine eigene Seitenleiste, ohne dass jede Seite sie selbst einbinden muss.
Die Trennung in +page.svelte und +page.server.ts ist bewusst gewählt. Was in der Server-Datei steht, gelangt nie in den Browser. Datenbankzugriffe und geheime Schlüssel sind dort richtig aufgehoben. SvelteKit verhindert zusätzlich, dass Module aus server-Ordnern wie src/lib/server oder private Umgebungsvariablen aus $app/env/private versehentlich in Browser-Code importiert werden; der Build bricht dann mit einer Fehlermeldung ab.
Daten laden mit der load-Funktion
Jede Seite kann eine Funktion namens load exportieren, die vor dem Rendern läuft und die Daten bereitstellt:
// src/routes/produkte/[id]/+page.server.ts
import { error } from '@sveltejs/kit';
import type { PageServerLoad } from './$types';
import { db } from '#lib/server/db.js';
export const load: PageServerLoad = async ({ params }) => {
const produkt = await db.produkt.finde(params.id);
if (!produkt) {
error(404, 'Produkt nicht gefunden');
}
return { produkt };
};
Die Seite erhält das Ergebnis als Eigenschaft data. Mit Svelte 5 sieht die Komponente so aus:
<!-- src/routes/produkte/[id]/+page.svelte -->
<script lang="ts">
import type { PageProps } from './$types';
let { data }: PageProps = $props();
</script>
<svelte:head>
<title>{data.produkt.name}</title>
</svelte:head>
<h1>{data.produkt.name}</h1>
<p>{data.produkt.beschreibung}</p>
Bemerkenswert ist der Import aus ./$types. SvelteKit erzeugt diese Typen automatisch aus der Ordnerstruktur. Gibt die load-Funktion ein Feld produkt zurück, weiß der Editor in der Seite, dass data.produkt existiert und welche Felder es hat. Tippfehler fallen so schon beim Schreiben auf, nicht erst im Betrieb. db steht hier stellvertretend für einen beliebigen Datenbankzugriff.
Neben +page.server.ts gibt es +page.ts. Eine load-Funktion dort läuft beim ersten Aufruf auf dem Server, bei der Hydration noch einmal und bei späteren Seitenwechseln im Browser. Das eignet sich für öffentliche Schnittstellen, die keine Geheimnisse brauchen.
Wie serverseitiges Rendering in SvelteKit abläuft
Ruft jemand eine Seite zum ersten Mal auf, führt der Server die load-Funktion aus, rendert die Komponente zu HTML und schickt das fertige Dokument. Der Browser zeigt den Inhalt sofort an, auch bevor JavaScript geladen ist. Anschließend lädt er den Code der Komponenten und macht die Seite interaktiv – dieser Schritt heißt Hydration. Von nun an verhält sich die Anwendung wie eine Single-Page-Anwendung: Klickt die Nutzerin auf einen Link, lädt SvelteKit nur noch die Daten der neuen Seite nach und tauscht den Inhalt aus, statt das ganze Dokument neu anzufordern.
Für Suchmaschinen und Vorschauen in Messengern ist das ein wichtiger Unterschied zu reinen Single-Page-Anwendungen: Titel, Text und Meta-Angaben stehen bereits im ausgelieferten HTML. Für Nutzer zählt vor allem, dass der Inhalt früher sichtbar wird. Weil Svelte vergleichsweise wenig Laufzeitcode mitbringt, fällt auch die Hydration oft schlanker aus als bei schwereren Frameworks. Konkrete Werte hängen aber stark von der jeweiligen Seite ab. Praxistipps dazu sammelt der Infothek-Artikel SEO und schnelle Ladezeiten trotz dynamischer Inhalte mit SvelteKit.
SSR, Prerendering und CSR pro Seite wählen
Server-Rendering ist die Voreinstellung, aber nicht die einzige Option. Über drei Schalter, die eine Seite oder ein Layout exportiert, lässt sich das Verhalten steuern:
// src/routes/ueber-uns/+page.ts
export const prerender = true; // beim Build als statisches HTML erzeugen
// src/routes/konto/+layout.ts
export const ssr = false; // Kundenbereich nur im Browser rendern
Mit prerender entsteht die Seite einmal beim Build, ideal für Impressum, Blog oder Unternehmensseiten. ssr = false lässt den Server aus, was sich für interne Bereiche hinter einem Login eignet. Mit csr = false verzichtet eine Seite komplett auf JavaScript im Browser, etwa eine rein informative Seite ohne jede Interaktion. Diese Wahl pro Route ist eine der Stärken von SvelteKit: Ein Projekt kann Marketingseiten, Produktkatalog und Kundenportal enthalten, jeweils mit der passenden Strategie.
Form Actions: Formulare, die auch ohne JavaScript funktionieren
Formulare sind in vielen Frameworks ein Umweg: Ein Klick löst JavaScript aus, das die Daten an eine Schnittstelle schickt und die Antwort auswertet. SvelteKit greift auf den ursprünglichen Mechanismus des Webs zurück. Ein HTML-Formular schickt seine Daten an den Server, und dort verarbeitet eine sogenannte Action die Eingabe:
// src/routes/kontakt/+page.server.ts
import { fail } from '@sveltejs/kit';
import type { Actions } from './$types';
export const actions: Actions = {
default: async ({ request }) => {
const formular = await request.formData();
const email = String(formular.get('email') ?? '');
if (!email.includes('@')) {
return fail(400, { email, fehler: 'Bitte eine gültige E-Mail-Adresse angeben.' });
}
await speichereAnfrage(email, String(formular.get('nachricht') ?? ''));
return { erfolg: true };
},
};
Das Formular in +page.svelte braucht dafür nur method="POST". Es funktioniert damit auch, wenn JavaScript noch nicht geladen, blockiert oder fehlgeschlagen ist. Ergänzt man das Formular um use:enhance aus $app/forms, übernimmt SvelteKit im Browser die Übertragung, ohne die Seite neu zu laden. Dieses Prinzip heißt progressive Verbesserung: Die Grundfunktion steht immer, der Komfort kommt hinzu, wenn die Technik es erlaubt. Für barrierearme Angebote und schwache Mobilverbindungen ist das ein handfester Vorteil.
API-Routen und Hooks für Serverlogik
Nicht jeder Server-Aufruf gehört zu einer Seite. Für reine Schnittstellen gibt es Dateien namens +server.ts, die Funktionen wie GET, POST oder DELETE exportieren und eine HTTP-Antwort zurückgeben. So lassen sich etwa ein Webhook für ein Zahlungssystem oder eine Suche für eine mobile App direkt im Projekt umsetzen.
Querschnittsaufgaben übernimmt die Datei src/hooks.server.ts. Ihre Funktion handle sieht jede Anfrage, bevor sie eine Seite erreicht. Typische Einsätze sind die Prüfung einer Sitzung, das Setzen von Sicherheits-Headern oder Protokollierung. Bei größeren Backends mit vielen Diensten bleibt SvelteKit trotzdem eher die Oberfläche samt dünner Vermittlungsschicht; die eigentliche Geschäftslogik liegt dann in eigenständigen Diensten.
Adapter: wo SvelteKit-Anwendungen laufen
Beim Build übersetzt ein Adapter die Anwendung für die gewünschte Zielumgebung. Offiziell gepflegt werden unter anderem Adapter für einen Node.js-Server, für rein statische Websites und für Plattformen wie Vercel, Netlify und Cloudflare. Die Voreinstellung adapter-auto erkennt einige dieser Plattformen selbstständig.
Für Unternehmen bedeutet das Wahlfreiheit. Mit adapter-node läuft die Anwendung in einem Docker-Container im eigenen Rechenzentrum oder bei einem deutschen Hoster, was Fragen der Auftragsverarbeitung vereinfachen kann. Mit adapter-static entsteht eine Sammlung von HTML-Dateien für jeden Webserver. Manche Funktionen hängen allerdings von der Plattform ab: Inkrementelle statische Regeneration, bei der vorab erzeugte Seiten im Hintergrund erneuert werden, bietet etwa nur der Vercel-Adapter.
Wo SvelteKit an Grenzen stößt
Das Ökosystem ist kleiner als das von React oder Vue. Für viele Aufgaben gibt es gute Svelte-Bibliotheken, bei speziellen Komponenten wie komplexen Datentabellen oder Diagrammen ist die Auswahl aber geringer, und manches muss selbst gebaut oder aus framework-unabhängigen Bibliotheken eingebunden werden. Auch der Bewerbermarkt ist enger: Entwickler:innen mit Svelte-Erfahrung sind seltener als solche mit React-Kenntnissen.
Der Wechsel auf Svelte 5 hat zudem eine Übergangsphase ausgelöst. Tutorials, Antworten in Foren und manche Bibliotheken beziehen sich noch auf die alte Syntax mit export let und Stores. Wer heute einsteigt, sollte darauf achten, aktuelle Quellen zu nutzen. Schließlich gilt für SvelteKit dasselbe wie für jedes Framework mit Server-Rendering: Der Server muss betrieben, überwacht und aktualisiert werden. Wer das vermeiden will, setzt konsequent auf Prerendering.
Was SvelteKit für Ihr Projekt bedeutet
Unsere Einschätzung: SvelteKit ist eine ausgereifte Wahl für Webprojekte, bei denen Ladezeit, Auffindbarkeit und überschaubarer Code im Vordergrund stehen – Unternehmenswebsites mit interaktiven Teilen, Produktkataloge, Portale und Dashboards. Die Konzepte sind schlank, die Nähe zu HTML-Formularen und Web-Standards zahlt sich langfristig aus, und die freie Wahl der Hosting-Umgebung ist ein echtes Argument.
Ob SvelteKit „die Zukunft des serverseitigen Renderings“ ist, wie es der ursprüngliche Titel dieses Beitrags nahelegte, lässt sich so nicht sagen. Next.js, Nuxt und SvelteKit verfolgen sehr ähnliche Ideen und haben sich gegenseitig beeinflusst. Die Entscheidung fällt meist über das vorhandene Wissen im Team und das Ökosystem. Ein Team mit viel React-Erfahrung ist mit Next.js oft besser bedient; ein Team, das neu beginnt oder mit wenig Code auskommen will, sollte SvelteKit ernsthaft prüfen. Einen Vergleich der Grundideen bietet der Beitrag Next.js: Wie Server-Rendering die React-Entwicklung verändert hat.
Wer SvelteKit für ein konkretes Vorhaben bewerten oder ein Team darauf schulen möchte, findet bei MARTINSFELD Beratung, Coaching und Seminare zu Svelte und SvelteKit.
Häufige Fragen zu SvelteKit
Setzt SvelteKit Svelte-Kenntnisse voraus?
Ja, zumindest die Grundlagen: Komponenten, Props, Ereignisse und die Runes von Svelte 5. SvelteKit baut darauf auf. Wer bereits React oder Vue kennt, lernt Svelte meist schnell, weil vieles näher an HTML und normalem JavaScript bleibt.
Ist SvelteKit für große Anwendungen geeignet?
Technisch ja. Typisierung, verschachtelte Layouts und die klare Trennung von Server- und Browser-Code helfen auch in großen Codebasen. Die Grenzen liegen eher beim Ökosystem und bei der Verfügbarkeit erfahrener Entwickler:innen als bei der Technik.
Kann SvelteKit eine rein statische Website erzeugen?
Ja. Mit adapter-static und prerender = true im obersten Layout entsteht eine Website aus HTML-Dateien, die auf jedem Webserver läuft – ganz ohne Node.js im Betrieb.
Wie unterscheidet sich SvelteKit von Next.js und Nuxt?
Die Konzepte sind verwandt: dateibasiertes Routing, Server-Rendering, Datenabruf vor dem Rendern und Serverfunktionen. Unterschiede liegen im Komponenten-Framework darunter, in der Größe des Ökosystems und in Details wie den Form Actions, die SvelteKit stärker an klassische HTML-Formulare anlehnt.
Kategorien
Schlagworte