Ich habe meine ganze Website in Python gezeichnet
Meine alte Seite hat gesagt, was ich mache, und nichts davon gezeigt. Diese hier ist ein einziger isometrischer Raum, gezeichnet von einem Python-Skript, eingefärbt über CSS-Variablen und an einem Arbeitstag durchwandert.
Meine alte Seite hat gesagt, was ich mache, und nichts davon gezeigt. Sie hatte eine große Überschrift, eine Liste von Leistungen und ein Kontaktformular, wie jede andere Entwicklerseite. Ich mag Websites, die eine Geschichte erzählen, und eine Liste von Artikeln hätte auch nicht gezeigt, wo meine Interessen liegen. Also habe ich stattdessen einen Ort gebaut: eine Roboterwerkstatt, ein Arbeitstag, jede Station eines der Dinge, die mir wichtig sind. Das ist die erste Schichtnotiz, und sie handelt von der Werkstatt selbst.

Das Thema finden
Die ersten Runden waren Logos und Farben. Sie waren in Ordnung und schnell vergessen. Gelöst hat es ein Ort, kein Stil: eine Werkstatt, in der jedes Interesse eine Station hat. Die Werkzeugwand ist Open Source, die Roboterarena ist Robotik und Physical AI, das Modelllabor sind Sprach- und Entscheidungsmodelle, die Lackiererei sind Interfaces und Landing Pages, die Fabrik im Keller ist, wie ich Software mit Agents baue, und der Etikettendrucker bei der Tür druckt das Produktionsprotokoll, also meinen Lebenslauf.
Ein Ort hat der Seite auch eine Stimme gegeben. Ein Serial Builder in einer Werkstatt hat Schichten, Teile, Qualitätskontrolle und eine Aufsicht. Die Aufsicht ist Abby, meine Französische Bulldogge, gezeichnet als Roboter.
Warum Code und keine Stock-Grafik
Ich wollte Vektorgrafik, die ich durch das Ändern einer einzigen Zahl anpassen kann, Farben aus CSS, damit der ganze Raum das Theme wechseln kann, und Teile, die sich bewegen können. Stock-Illustrationen geben dir nichts davon, und Bildgeneratoren geben dir ein Bild, das du nicht bearbeiten kannst. Also erzeugt ein kleines Python-Skript die Grafik, und jede Farbe darin ist eine CSS-Variable wie var(--w1) oder var(--a2).
Der Preis dafür ist eine Obergrenze. Kisten, Paneele und Kabel sind in Code einfach. Organische Formen sind schwer, und an diese Grenze bin ich gestoßen, sobald ich mit Abby angefangen habe.
Isometrische Projektion in ein paar Zeilen
Der ganze Raum ruht auf einer Funktion. Ein Punkt im Raum, x und y am Boden und z nach oben, wird zu einem Punkt am Bildschirm:
C, S = math.cos(math.radians(30)), 0.5
def P(x, y, z=0):
return (ox + (x - y) * C * k, oy + (x + y) * S * k - z * k)
Alles andere ist aus Kisten gebaut. Eine Kiste besteht aus drei Polygonen, der Seite zu dir, der Seite nach rechts und der Oberseite, jede in einem helleren oder dunkleren Ton derselben Farbe. Diese flache Schattierung und eine einzige Linienstärke sind der ganze Stil.
def box(x, y, z, w, d, h, tone="w"):
top, front, side = TONES[tone]
poly([(x, y+d, z), (x+w, y+d, z), (x+w, y+d, z+h), (x, y+d, z+h)], front)
poly([(x+w, y, z), (x+w, y+d, z), (x+w, y+d, z+h), (x+w, y, z+h)], side)
poly([(x, y, z+h), (x+w, y, z+h), (x+w, y+d, z+h), (x, y+d, z+h)], top)
Das Skript zeichnet der Reihe nach, von hinten nach vorne, also verdeckt alles Spätere, was davor kam. Flache Dinge an den Wänden (das Whiteboard, die Werkzeugwand, das Fenster) werden einmal flach gezeichnet und dann mit einer einzigen Transformation auf die Wand gelegt. Die Website verwendet dieselbe Funktion mit denselben Zahlen, sodass alles, was sich auf der Seite bewegt, genau auf dem Boden der Zeichnung landet.
Abby, der schwierige Teil

Abby hat mehr Runden gebraucht als der ganze restliche Raum zusammen. Ein flacher Cartoon sah billig aus. Schattierte 3D-Ellipsoide sahen immer noch billig aus. Ein kompletter Roboterhund kam näher, aber das war nicht sie. Ein echter Frenchie-Kopf auf dem Roboterkörper war fast am Ziel: ihr runder Schädel und ihre dunkle Maske, ihre Fledermausohren, ein Körper aus Platten und Gelenken. Der letzte Schritt war ein dunkles Visier über den Augen. Es verbindet den Kopf wieder mit dem Roboter, und die Augen bleiben zwei einfache Formen, die trotzdem eine Stimmung zeigen.

Was ich gelernt habe: Der Realismus steckt im Kopf. Ein Roboterkörper verzeiht einfache Formen, also kann er im selben Kistenstil bleiben wie der Raum. Und jede Pose, sitzend, gehend, schlafend auf ihrem Kissen, auf dem Rücken, wenn du sie lange genug streichelst, ist aus denselben Teilen gebaut, also sieht sie in allen wie derselbe Hund aus.
Ein Raum, ein Tag
Die Seite ist eine einzige Zeichnung, einmal eingebunden und durch verschiedene Fenster gezeigt. Jede Station ist ein Kamerabild auf denselben Raum. Beim Scrollen fährt die Kamera von einem Bild zum nächsten, während eine Uhr von 08:00, Türen auf, bis 18:00, Licht aus, läuft. Abby geht zwischen den Stationen um die Möbel herum, und am Ende des Tages geht sie zurück zu ihrem Kissen.

Die Fabrik, Station 05, ist die Ausnahme: Sie ist ein Keller unter der Werkstatt, und Abby fährt mit dem Rover einen Lift hinunter, um hinzukommen.
Das Logo, und warum kleine Größen eine eigene Zeichnung sind
Das Logo ging durch sechs Konzepte, bevor die offene Kiste gewonnen hat. Es funktioniert bei 256 Pixeln und fällt bei 16 auseinander: Der Griff wird zum Fleck, und die Kontur frisst die Flächen. Also sind die kleinen Größen eine eigene, einfachere Zeichnung, so wie Schriftgestalter kleine Größen einer Schrift anders zeichnen.

Dark Mode, fast geschenkt
Weil jede Farbe eine Variable ist, ist die Nachtschicht großteils ein zweiter Satz Werte. Die Extras sind das, was sie nach Nacht aussehen lässt: ein Mond im Fenster, warmes Licht von den Lampen, kleine LEDs, die leuchten, und Abby, die schläft. Der Lichtschalter zeigt das neue Theme in einem Kreis, der vom Schalter aus wächst.

Dinge zum Finden
Ich zähle nicht alle auf. Der Rover plant seine Route mit echter Wegfindung. Abby hat Launen, und sie mag Leckerlis. Es gibt eine Tür, die beim ersten Versuch nicht aufgeht. Die 404-Seite ist eine leere Kiste. Und wenn du auf der Startseite X drückst, zeigt dir der Raum, wie er gezeichnet wurde.

Schnell machen
Eine Zeichnung, durch die man scrollt, ist trotzdem eine Webseite, und ich wollte keine schöne, die lädt wie eine langsame. Also habe ich gemessen, auf einem Production-Build, am Laptop und mit einem Handy-Profil (Fast 4G, eine viermal langsamere CPU), und mir zuerst die größten Zahlen vorgenommen. Auf der Seite hat sich dabei nichts verändert.
| Handy, Startseite | Vorher | Nachher |
|---|---|---|
| Geladen | 1,1 MB | 0,59 MB |
| Größter Paint | 4,3 s | 0,9 s |
| Andere Seiten, geladen | 0,7 bis 1,7 MB | 0,33 bis 0,41 MB |
| Andere Seiten, größter Paint | 2,5 s | 0,5 s |
Was ich gelernt habe, in der Reihenfolge, in der es sich gelohnt hat:
- Generierte Grafik bringt die Gewohnheiten des Generators mit. Abby war schwerer als alle drei Räume zusammen: 1 MB für zwölf Posen. Das Skript macht aus jeder Kurve Hunderte kurze Linien mit zwei Nachkommastellen und zeichnet jede beschnittene Form doppelt. Ein kleiner Schritt beim Export vereinfacht jetzt die Umrisse (nie weiter als eine Viertel-Einheit, unter einem halben Pixel bei der größten Darstellung), schreibt die Pfade mit relativen Zahlen und einer Nachkommastelle und jede Form nur einmal. Jetzt sind es 0,36 MB. Ich habe jede Pose vorher und nachher in dreifacher Größe gerendert und die Pixel verglichen: weniger als einer von zehntausend weicht ab, alle an den Kanten.
- Versteckt ist nicht gratis. Der Raum hatte noch die Abby dabei, die das Skript in ihn hineinzeichnet, 143 seiner 186 KB, mit
display: noneausgeschaltet, seit die Seite sie selbst zeichnet. Der Browser hat sie trotzdem auf jeder Seite geladen und gelesen. Jetzt ist sie aus der Datei raus. - Inline-SVG zahlt man doppelt. Mit React Server Components landet alles, was eine Server-Komponente rendert, im HTML und noch einmal in den Daten, mit denen React die Seite übernimmt. Jedes Kilobyte Grafik zählt doppelt, deshalb hat das Abspecken so viel gebracht.
- Prefetching ist auch nicht gratis. Der Link "Workshop" im Header hat auf jeder Seite die ganze Startseite samt Grafik vorgeladen, sogar auf der Startseite selbst: 1,5 MB Daten, meistens ungenutzt. Jetzt lädt er vor, wenn du auf ihn zeigst. Und eine vorgeladene Notiz hat ihre Bilder gleich mitgeholt, die Notizenliste hat also 1,5 MB Bilder geladen, die niemand angeschaut hat. Die Bilder laden jetzt lazy und als WebP: ein Drittel der Größe, und bis auf zwei Pixel für Pixel gleich.
- Ein Fade kann deine Seite vor dem Browser verstecken. Die Animationen beim ersten Laden starteten bei Opacity 0. Chrome zählt Inhalt, der mit Opacity 0 gemalt wird, nicht als größten Paint, und hat die Seite deshalb 1,6 s zu spät gemessen, am Ende der Animation, obwohl man sie nach ein paar hundert Millisekunden sehen konnte. Bei 0,01 zu starten sieht gleich aus und korrigiert die Zahl.
- Schriften: nur die Buchstaben, die du brauchst. Jede Schrift hat zusätzlich einen erweiterten Lateinsatz geladen. Die Seite braucht nichts davon, nicht einmal für die deutschen Seiten.
Das Spiel im Garten hatte eigene Lektionen. Die Möbel des Raums werden vor Abby und den Rover gezeichnet, indem extra Kopien des ganzen Raums beschnitten werden, und Kopien, die mit visibility versteckt sind, kosten den Browser trotzdem in jedem Frame Arbeit. Mit display versteckt kosten sie nichts. Solange das Spiel offen ist, pausiert jetzt die Seite dahinter (content-visibility: hidden), und der Sonnenuntergang blendet die Farben nur im Spiel über. Er lief vorher mit etwa sieben Bildern pro Sekunde, jetzt mit flüssigen sechzig.
Was noch offen ist: Auf einem langsamen Handy beschäftigt die Startseite den Main Thread noch etwa eine Sekunde lang, während sie ein 1,8 MB großes Dokument liest. Der nächste Schritt ist, die Grafik als Dateien auszuliefern, die der Browser einmal cacht, statt sie in jede Seite einzubetten.
Wie es entstanden ist
Ich habe an einem Wochenende in Runden daran gearbeitet: eine Richtung wählen, anschauen, ändern, was mich stört, nächste Runde. Herausgekommen ist kein Mock-up, sondern ein Paket: eine schriftliche Spezifikation, der Python-Generator und die Assets, die er exportiert. Aus diesem Paket habe ich die Seite auf meinem eigenen Website-Template gebaut und sie dann in kleinen Schritten wachsen lassen, ein Feature oder ein Fix nach dem anderen, jedes in einem echten Browser geprüft.
Was funktioniert hat, war die Reihenfolge. Der Look stand als Zeichnungen fest, bevor es irgendeine Seite gab, und die Spezifikation hat in einfachen Sätzen gesagt, was die Seite können soll. Was ich anders machen würde: das Koordinatensystem der Grafik und das der Website von Anfang an gemeinsam festlegen. Einige der fummeligsten Arbeiten später waren, Dinge, die die Seite zeichnet, wie Abby und den Rover, genau mit Dingen in Deckung zu bringen, die das Skript gezeichnet hat.
Der Generator bleibt vorerst privat. Die Seite hängt an meiner eigenen Werkzeugwand, und genau darum geht es.