Case Study

Wie SwitchForge gebaut ist

SwitchForge ist ein Portfolio-Projekt: ein 3D-Konfigurator für mechanische Keyboards mit echtem Checkout, gebaut mit der Vorgabe null laufende Kosten. Kein Modell-Asset, keine Datenbank, keine Sound-Dateien – alles, was man sieht und hört, entsteht im Code. Hier sind die Entscheidungen dahinter.

Stack

SvelteKit 2 · Svelte 5 Runes
Feingranulare Reaktivität, kein VDOM, kleiner Output
Threlte · Three.js
3D-Szene deklarativ, prozedurale Geometrie, Bloom via postprocessing
Tailwind v4 · Shadcn-Svelte
OKLCH-Tokens, Shadcn-Komponenten auf die eigene Palette gemappt
WebAudio
Switch-Sounds als Resonator-Synthese, Samples optional
Stripe Checkout
Test-Modus, Konfiguration als Metadata – Stripe ist das Order-System
Vercel · Neon
Hobby-Tier, Serverless-Routes; Postgres (Free-Tier) nur für Teil zwei

Warum Svelte? Ein Konfigurator ist ein Reaktivitätsproblem: eine Farbänderung soll genau ein Material anfassen, nicht ein Panel mit 40 Buttons neu rendern. Svelte 5 macht das ohne memo-Disziplin. Der kompilierte Output ist klein, was zählt, wenn danach 600 KB Three.js kommen.

Vier Entscheidungen

01Der Server rechnet Preise aus IDs – nie aus Beträgen

Der Client schickt nur Konfigurations-IDs und Mengen. /api/checkout löst sie gegen den Katalog auf, validiert jede einzelne und rechnet den Preis mit derselben pricing.ts, die auch der Browser nutzt. Wer den Request manipuliert, bekommt trotzdem den echten Preis. Alle Beträge sind Integer-Cent – keine Float-Rundung, genau das Format, das Stripe erwartet.

// pricing.ts – reine Funktionen, Client und Server
const build = resolveBuild(config);        // IDs → Katalogobjekte
const price = computePrice(build);         // Integer-Cent
if (!isValidConfig(config)) error(400);    // Server: strikt, kein Fallback

02Tastatur-Layouts sind Daten, keine Komponenten

Jede Reihe ist ein String in einer Mini-DSL – Breiten in Units, Lücken, Codes. Daraus entstehen Position und Größe jeder Taste UND das Mapping KeyboardEvent.code → Taste. Deshalb tippt das 3D-Board mit, wenn du auf deiner echten Tastatur schreibst: code ist positionsbezogen, das Label nur Kosmetik. Deutsch/Englisch ändert Legenden, nicht Physik.

'Tab:1.5 Q W E R T Y U I O P [ ] \\:1.5'
'⇧=ShiftLeft:2.25 Z X C V B N M , . /'
'Ctrl=ControlLeft:1.25 Win:1.25 Alt=AltLeft:1.25 Space:6.25 …'

03Prozedurales 3D ohne ein einziges Modell-Asset

Kein GLTF, kein Blender. Keycaps sind Rounded Boxes, die per Vertex-Loop nach oben verjüngt werden (Cherry-Profil). Das Case ist eine Extrusion mit Fase. Legenden sind SDF-Text, Backlight ist eine emissive Platte, RGB eine 256-Pixel-Textur, deren Offset wandert. Bloom macht daraus Licht. Eine Geometrie pro Keycap-Breite, zwei Materialien pro Set – 87 Tasten kosten keine 87 Shader.

// Keycap-Taper: x/z abhängig von der Höhe skalieren
const t = (y + h / 2) / h;        // 0 unten … 1 oben
const k = 1 - 0.16 * t;           // oben 16 % schmaler
pos.setX(i, pos.getX(i) * k);

04Sound aus Physik statt aus Samples

Ein Anschlag ist ein Impuls, der das Gehäuse anregt – und das Gehäuse schwingt in seinen Eigenfrequenzen aus. Genau das wird gebaut: Rauschburst → vier Bandpass-Resonatoren → plus Bottom-out-Thud mit fallender Tonhöhe, einmal in einem OfflineAudioContext gerendert. Die Platte färbt den Klang (Messing höher und länger, Polycarbonat weicher). Legt man echte MP3s ab, werden sie bevorzugt.

linear: modes [175 Hz Q9, 340 Q10, 720 Q7, 1600 Q5], thud 95 Hz
brass:  f ×1.18, Q ×1.4, lowpass ×1.35   // steif → "ping"

Performance

  • Three.js lädt nach dem ersten Paint

    Header, Panel, Preis sind sofort da; die Szene blendet sich ein.

  • DPR auf 1.5 gedeckelt

    Retina rendert sonst 4× so viele Pixel für einen Unterschied, den man in dunklen Szenen nicht sieht.

  • Rendering on demand

    Frames nur bei Änderung. Materialwechsel rufen invalidate() – sonst bleibt das Bild stehen.

  • Tastendruck ≠ Konfiguration

    Eigener Store für gedrückte Tasten. Tippen löst keine Preis-Neuberechnung aus.

  • RGB-Legenden ohne Re-Render

    Eine Color pro Taste, pro Frame mutiert. Troika kopiert Color-Objekte beim Rendern – Svelte sieht nichts davon.

  • Symbolschrift: 5 KB

    DejaVu auf 25 Glyphen gesubsettet, weil das Latin-Subset von JetBrains Mono keine ⇧ ← → hat.

Null laufende Kosten

Vercel Hobby, Stripe im Test-Modus, keine Datenbank. Supabase war zuerst im Plan und flog raus: Der Free-Tier pausiert Projekte nach sieben Tagen Inaktivität – ein Portfolio, das jemand drei Wochen nach dem letzten Besuch öffnet, wäre kaputt. Stripe speichert jede Checkout-Session inklusive Konfiguration; für ein Demo ist das das Order-System.

Teil zwei: echte Bestellungen

Stripe als Order-System reicht für ein Demo – nicht für einen Shop, in dem jemand nachschauen will, wo sein Board ist. Deshalb gibt es optional ein schlankes Backend, das die Demo nicht braucht, aber nutzt, sobald es konfiguriert ist:

  1. Neon Postgres + Drizzle – zwei Tabellen: Bestellungen und verarbeitete Stripe-Events. Neon statt Supabase, weil der Free-Tier nicht dauerhaft einschläft.
  2. Idempotenter Webhook – die Event-ID wird vor der Verarbeitung eingetragen. Schickt Stripe dasselbe Event dreimal, entsteht trotzdem eine Bestellung. Scheitert das Anlegen, wird die Markierung zurückgenommen, damit Stripes Retry greift.
  3. Status-Seite per Token statt Accounts – Link in der Bestätigungsmail, Timeline bezahlt → gebaut → versendet → zugestellt. Gast-Checkout ist, was Custom-Keyboard-Shops tatsächlich machen.
  4. Mini-Admin – ein Passwort, ein HMAC-Cookie, Status ändern, Tracking eintragen. Jeder Statuswechsel schickt eine Mail (Resend, Free-Tier).

Was bewusst fehlt: Lagerbestand, Retouren, AGB, Widerruf, MwSt-Logik. Das ist der Teil, der erst bei echtem Betrieb Sinn ergibt.