Ein gemischter Tag: Zwei Seiten haben neue Texte bekommen, ein kleiner optischer Bug wurde zu drei Anläufen, bevor die Lösung wirklich hielt, und ein echter Fehler, durch den Blogbeiträge leer luden, wurde gefunden und behoben. Hier ist alles, in der Reihenfolge, in der es passiert ist.
Neue Worte für Start- und Über-mich-Seite
Die Überschrift der Startseite wurde von „Websites für Handwerk und Mittelstand“ zu etwas Weiterem: „Was Sie sich vorstellen können, bauen wir gemeinsam.“ – mit denselben Wurzeln in Handwerk und Mittelstand, aber mit Platz für die persönlichen Projekte und alles dazwischen, was ich ebenfalls übernehme, nicht nur Firmenwebsites.
Die Über-mich-Seite bekam einen eigenen neuen Text, keine Kopie der Startseite – mit denselben Fakten im Hintergrund (der Metallbaubetrieb, zwei Jahrzehnte in der Fertigung, die Jahre mit Produktion in China), aber erzählt aus Verständnis statt als Verkaufsargument: „Bevor ich Websites gebaut habe, habe ich einen Betrieb wie Ihren geführt.“ Das soll sich lesen wie die Beruhigung von jemandem, der tatsächlich schon dort saß, wo heute ein Inhaber aus Handwerk oder Mittelstand sitzt – nicht wie eine weitere Verkaufsseite. Beide Texte gingen neben dem englischen auch auf Deutsch, Chinesisch und Japanisch online.
Eine Ecke, die drei Anläufe brauchte
Der Hero der Experiment-Seite hat als Hintergrund einen live laufenden WebGL-Shader, der wie jedes andere Panel der Website in einer Karte mit abgerundeten Ecken sitzt. Diese Ecken auch wirklich rund aussehen zu lassen, wurde zum hartnäckigsten Bug des Tages.
- Erster Anlauf: Die bestehende Lösung (das Canvas-Element selbst per CSS abrunden) hatte in Chrome gehalten, war aber wieder eckig – Firefox ignorierte sie und malte das Canvas als scharfkantiges Rechteck, egal was im CSS stand. Ich habe
clip-pathals zweiten, unabhängigen Weg zum Beschneiden ergänzt. In Firefox blieb es eckig. - Zweiter Anlauf: Da man dem Beschneiden eines von der GPU zusammengesetzten Canvas per CSS offenbar nicht trauen kann, habe ich die Rundung in den Shader selbst verlegt – im Fragment-Shader werden alle Pixel außerhalb eines abgerundeten Rechtecks verworfen, sodass das Canvas seine transparenten Ecken selbst malt, egal was der Compositor eines Browsers mit der Ebene anstellt. In meinem eigenen Testbrowser sah das perfekt aus. Auf dem echten Rechner, für den es eigentlich gedacht war, passierte etwas Schlimmeres: Die sichtbare Farbe schrumpfte zu einem kleinen Fleck, der mitten in einem viel größeren dunklen Kasten schwebte. Warum genau, habe ich nie ganz herausgefunden – irgendein Zusammenspiel mit der tatsächlichen GPU oder dem Treiber, das ich nicht nachstellen konnte. Statt weiter an Mathematik herumzuraten, die ich nicht überprüfen konnte, habe ich es zurückgenommen.
- Dritter Anlauf: zurück zu CSS, aber mit einer anderen Art von Lösung – das Canvas steckt jetzt in einem zusätzlichen
<div>, das das Beschneiden übernimmt, statt die Ebene des Canvas direkt zu beschneiden. Das ist der übliche, gut dokumentierte Workaround für genau diese Sorte Bug, und er hat in beiden Browsern tatsächlich gehalten.
Diese dritte Lösung brachte eine eigene kleine Regression mit: Der Lichtschein des Shaders, der dem Mauszeiger folgt, reagierte nur noch, wenn die Maus direkt über dem Canvas war. Der Code zum Verfolgen der Maus lauschte auf das Elternelement des Canvas – früher war das der gesamte Hero-Bereich (Bewegungen über der Überschrift oder der Navigation zählten also mit), aber nach dem Einfügen des zusätzlichen <div> war „Elternelement“ nur noch dieser schmale Rahmen. Den Listener ausdrücklich auf den Hero-Bereich umgehängt – und der Effekt folgt dem Mauszeiger wieder überall.
Jeder Blogbeitrag geprüft – und ein Test, der Schriftfarben-Regressionen findet
Ich bin alle neun Beiträge und die Blog-Übersicht einzeln durchgegangen: geprüft, dass jedes Bild tatsächlich lädt, jeder interne Link ankommt und die Konsole überall sauber ist. Ein Neubau aller Beiträge aus dem Markdown-Quelltext ergab bytegleiche Ergebnisse – veraltet war dort also nichts.
Wo es gerade um Dinge ging, die stillschweigend kaputtgehen können: Ich habe ein kleines Skript zur Kontrastprüfung gebaut (check-contrast.js, ohne Abhängigkeiten). Es liest jede Kombination aus Textfarbe und Hintergrund, die diese Website tatsächlich verwendet – die dunkle und die helle Palette der gesamten Website sowie jede Seite, die ihre eigenen Farben festlegt, etwa den immer dunklen Hintergrund im Hero der Experiment-Seite –, und prüft für jede das WCAG-Kontrastverhältnis. Es soll genau den Fehler automatisch abfangen, bei dem man eine Farbe ändert und dadurch versehentlich irgendwo Text vor seinem Hintergrund unlesbar macht – auf jeder Seite, ohne darauf angewiesen zu sein, dass es zufällig jemandem auffällt. Getestet habe ich das, indem ich absichtlich eine schlechte Farbe eingeschleust, bestätigt habe, dass die Prüfung laut fehlschlägt, und die Änderung dann zurückgenommen habe.
Der Blog versteckte seine eigenen Worte
Das hier war der Fehler, auf den es wirklich ankam: Blogbeiträge luden mit sichtbarem Kopfbereich, aber unsichtbarem Artikeltext, bis man nach unten scrollte. Jeder Abschnitt unterhalb des Hero-Bereichs war in einen Einblend-Effekt beim Scrollen gehüllt – standardmäßig versteckt, sichtbar erst, wenn er ins Bild scrollt –, und weil der Hero eines Beitrags den Großteil des ersten Bildschirms füllt, lag der gesamte Artikel darunter und war im Moment des Ladens praktisch unsichtbar.
Das Beunruhigende daran: Ich war alle neun Beiträge schon gezielt auf genau diese Art Problem durchgegangen und hatte es nicht bemerkt. Meine Prüfungen scrollten schnell und machten direkt danach einen Screenshot – und erwischten dabei ein paarmal die Animation selbst mitten im Übergang. Das hatte ich als Timing-Artefakt meines eigenen Tests abgetan, nicht als echten Bug, und war weitergegangen. Ich war damit näher am eigentlichen Problem, als ich mir zugestanden hatte; ich war nur nicht langsam genug geworden, um die tatsächliche, schlimmere Version zu sehen, die ein ganz normaler Besucher erlebt.
Die Lösung: Der Einblend-Effekt ist vollständig aus den Blog-Vorlagen entfernt statt aus den einzelnen Seiten – so kann er nicht stillschweigend zurückkehren, wenn ein Beitrag das nächste Mal neu gebaut wird. Danach habe ich den Build für alle neun Beiträge und die Übersicht laufen lassen, sodass alle auf einmal die Korrektur bekommen haben, nicht nur die, über die sich jemand beschwert hatte.
Nichts davon war für sich genommen dramatisch, aber über das Muster lohnt es sich nachzudenken: Zwei der heutigen Korrekturen haben auf dem Weg zum Funktionieren etwas anderes kaputtgemacht (eine Shader-Lösung, die auf echter Hardware schrumpfte, eine Beschneide-Lösung, die das Mausverfolgen lahmlegte), und der wichtigere Bug war einer, über den mein eigener automatischer Durchgang bereits hinweggesehen hatte. Automatische Prüfungen sind es wert – gerade das Kontrastskript sollte eine echte Kategorie von Fehlern abfangen, bevor sie online gehen –, aber sie ersetzen nicht, dass jemand tatsächlich hinschaut. Nehmen Sie gern Kontakt auf, wenn Ihr eigenes Projekt diese Art von Aufmerksamkeit braucht.
A mixed day — two pages got new words, one small visual bug turned into three attempts before it actually stuck, and a real "blog posts load blank" bug got found and fixed. Here's the whole thing, in the order it happened.
New words for the Home and About pages
The Home page's header went from "Websites for Handwerk and Mittelstand businesses" to something broader: "Whatever you can imagine, we can build together." — same Handwerk/Mittelstand roots, but making room for the personal projects and everything-in-between work I also take on, not just business sites.
The About page got its own rewrite, not a copy of the Home page's — same underlying facts (the metalworking business, two decades in manufacturing, the years with operations in China), but framed around empathy instead of a pitch: "Before I built websites, I ran a business like yours." It's meant to read as reassurance from someone who's actually sat where a Handwerk or Mittelstand owner is sitting, not as another sales page. Both went out in German, Chinese, and Japanese alongside the English.
A corner that took three tries
The Experiment page's hero has a live WebGL shader for a background, sitting inside a rounded card like every other panel on the site. Getting its corners to actually look rounded turned into the most stubborn bug of the day.
- Try one: the existing fix (rounding the canvas element's own box via CSS) had held in Chrome but come back squared-off — Firefox was ignoring it, painting the canvas as a hard-edged rectangle regardless of what CSS said. I added
clip-pathas a second, independent way to clip it. Still square in Firefox. - Try two: since CSS clipping of a GPU-composited canvas is apparently not something to trust, I moved the rounding into the shader itself — discarding the pixels outside a rounded rectangle in the fragment shader, so the canvas paints its own transparent corners no matter what any browser's compositor does with the layer. This rendered perfectly in my own test browser. On the real machine it was actually meant for, it did something worse: the visible color shrank into a small blob floating in the middle of a much bigger dark box. I never fully pinned down why — some interaction with the actual GPU/driver I couldn't reproduce — so rather than keep guessing at math I couldn't verify, I reverted it.
- Try three: back to CSS, but a different shape of fix — wrapping the canvas in an extra
<div>that does the clipping, instead of clipping the canvas's own layer directly. This is the standard, well-documented workaround for exactly this class of bug, and it's the one that actually held across both browsers.
That third fix introduced its own small regression: the shader's cursor-tracking glow stopped reacting to the mouse anywhere except directly over the canvas. The mouse-tracking code was listening on the canvas's parent element — which used to be the whole hero section (so moving your mouse over the headline or nav counted), but after the wrapper div was inserted, "parent" meant just that narrow wrapper. Re-pointed the listener at the hero section explicitly, and the cursor-follow effect works everywhere again.
Auditing every blog post, and a test that catches font-color regressions
Went through all nine posts and the blog index one at a time — checked every image actually loads, every internal link resolves, and the console is clean on each. Rebuilding all of them from the source Markdown produced byte-identical output, so nothing there was actually stale.
While on the subject of things that can quietly break: built a small contrast-checking script (check-contrast.js, no dependencies) that reads every text-color-on-background pairing this site actually uses — the sitewide dark and bright palettes, plus any page that pins its own colors, like the Experiment hero's always-dark backdrop — and checks the WCAG contrast ratio for each one. It's meant to catch the specific mistake of changing a color and accidentally making some text unreadable against its background, on any page, automatically, instead of relying on someone happening to notice. Tested it does its job by deliberately injecting a bad color, confirming it failed loudly, then reverting.
The blog was hiding its own words
Here's the one that actually mattered most: blog posts were loading with the header visible but the article body invisible until you scrolled down. Every section below the hero was wrapped in a scroll-triggered fade-in — hidden by default, revealed once it scrolled into view — and since a post's hero fills most of the initial screen, the entire article sat below the fold, effectively invisible the moment the page loaded.
The unsettling part: I'd already gone through all nine posts looking for exactly this kind of problem, and hadn't caught it. My checks scrolled quickly and screenshotted immediately after, which happened to catch the animation itself mid-transition a couple of times — I wrote those off as timing artifacts of my own testing, not real bugs, and moved on. They were closer to the real issue than I gave them credit for; I just hadn't slowed down enough to see the actual, worse version of it a normal visitor would hit.
Fixed by removing that fade-in from the blog templates entirely, rather than the individual pages — so it can't quietly come back the next time a post gets rebuilt. Ran the build for all nine posts and the index afterward, so every one of them picked up the fix at once, not just whichever ones had been complained about.
Nothing today was dramatic on its own, but the pattern's worth sitting with: two of today's fixes broke something else on the way to working (a shader fix that shrank on real hardware, a clipping fix that killed mouse tracking), and the more important bug was one my own automated pass had already looked past. Automated checks are worth having — the contrast script especially should catch a real category of mistake before it ships — but they're not a substitute for someone actually looking. Get in touch if that kind of attention is what your own project needs.
Hat Ihnen dieser Beitrag gefallen?
Ich freue mich über Ihr Feedback oder ein Gespräch über Ihr eigenes Projekt.
Kontakt aufnehmen