Blog

Ein echtes Kundenangebot entstehtBuilding a Real Client Pitch

Ein echtes, noch nicht öffentliches Angebot für einen Metallbau- und Schlossereibetrieb – gebaut nach einem strengen Briefing, geprüft in einem echten Browser, mit einem Validator und einer Kontrastformel, und mit echten Bugs, die vor der Übergabe gefunden und behoben wurden.A real, still-private pitch for a metalworking and locksmithing business — built to a strict brief, checked in an actual browser and against a validator and a contrast formula, with real bugs caught and fixed before handoff.

Michael Roehn, Webentwickler in Bad Kreuznach
← Zurück zum Blog

Die anonymisierte Beispiel-Website, die schon im Portfolio steht, und der Beitrag darüber, wie sie bereinigt wurde, drehen sich um dasselbe Projekt: ein echtes Angebot für einen echten Metallbau- und Schlossereibetrieb, das noch passwortgeschützt und nicht öffentlich ist, während der Betrieb überlegt, ob er es umsetzen lässt. In jenem Beitrag ging es darum, was gelöscht wurde, bevor irgendetwas öffentlich wurde. In diesem geht es um den Bau selbst – keine Namen, kein Ort, nichts, was auf echte Menschen zurückführt, nur die Frage, wie das Ganze tatsächlich entstanden ist.

Am Anfang ein Briefing, kein leeres Blatt

Bevor ich eine Zeile HTML geschrieben habe, habe ich mir selbst ein Briefing geschrieben: nur eine statische Website, handgeschriebenes HTML und einfaches CSS, kein Framework, kein Build-Schritt, keine CDN-Anfragen zur Laufzeit – alles selbst hosten, denn das ist eine deutsche Website, und wegen der DSGVO ist das keine Kür, sondern Pflicht. Niemals einen Fakt erfinden: Preise, Zertifikate, Öffnungszeiten, Mitarbeiterzahl, Einsatzradius – alles nur so, wie es das Material des Kunden tatsächlich hergab. Was fehlt, kommt als offene Frage auf eine Liste und wird im HTML mit [TBD] markiert – nie stillschweigend mit selbstbewusst klingendem Fülltext überdeckt.

Die Rahmenbedingungen vor jeder Gestaltungsentscheidung aufzuschreiben, ist das, was einen KI-gestützten Bau ehrlich hält. Gegen eine schriftliche Regel lässt sich „das gehört nicht auf die Website eines echten Betriebs“ viel leichter erkennen als gegen ein vages Gefühl, dass irgendetwas nicht stimmt.

Phase 0: jedes Foto ansehen, bevor irgendetwas entschieden wird

Der Kunde hatte einen Ordner mit echten Fotos geliefert – die Werkstatt, fertige Arbeiten, ein Porträt des Inhabers. Bevor irgendein Layout skizziert wurde, habe ich jedes einzelne geöffnet und erfasst: Pixelgröße, Ausrichtung, was tatsächlich im Bild ist – so konkret beschrieben, dass sich zwei ähnliche Aufnahmen auseinanderhalten lassen –, dazu eine Qualitätsstufe von A (taugt für den Hero) bis X (nicht verwenden: unscharf, das Gesicht eines Fremden im Bild, ein sichtbares Kennzeichen, unruhiger Hintergrund). Wo ein Kennzeichen oder ein Passant herausgeschnitten werden musste, wurde das direkt dort vermerkt.

Die wichtigste Regel: Nur Fotos, die tatsächlich angesehen wurden, durften im Plan auftauchen. Hatte ein Abschnitt der Website kein echtes Foto als Grundlage, wurde er entweder als reine Typografie mit Strichzeichnungen neu gedacht oder es gab ihn nicht – nie ein grauer Platzhalterkasten, der später gefüllt werden soll. Drei Seiten mit echtem Inhalt schlagen acht dünne mit Stockfoto-Anmutung.

Absage an die KI-Standards

Der Gestaltungsplan musste eine konkrete Farbpalette und Schriftkombination benennen, bevor irgendein CSS geschrieben wurde – und er musste ausdrücklich eine bestimmte Liste dessen ausschließen, was ich inzwischen „KI-Standards“ nenne: cremefarbener Hintergrund mit kontrastreicher Serifenschrift und Terrakotta-Akzent, Fast-Schwarz mit Giftgrün, ein generischer Zeitungslook mit Haarlinien und nirgends abgerundeten Ecken, Kartenraster mit Schlagschatten als einzige visuelle Idee, Verläufe von Lila nach Blau, Icon-Fonts. Alles sofort wiederzuerkennen, und alles genau das, was standardmäßig herauskommt, wenn niemand der ersten plausiblen Antwort widerspricht.

Stattdessen kam die Palette aus der Materialwelt des Handwerks selbst – Stahl, die verschiedenen Oberflächen, die Edelstahl tatsächlich annimmt, Patina, der Stein, aus dem die Region gebaut ist. Bevor ich den Plan vorgestellt habe, kam die Probe aufs Exempel: Hätte ich genau das für die Website irgendeines Handwerkers gebaut? Wo die Antwort Ja lautete, wurde dieser Teil geändert.

Eine Palette, die sich änderte, nachdem der Kunde sie gesehen hatte

Die aus dem Material abgeleitete Palette war der Plan. Das letzte Wort war sie nicht. Nachdem der Kunde sie gesehen hatte, wünschte er sich eine zweite Variante, direkt abgenommen von der Beschilderung seiner eigenen Werkstatt – Marineblau und Weiß, ganz ohne die Stahl-und-Stein-Logik des Briefings, einfach das, was schon an seinem Gebäude steht.

Beide Paletten sind als Umschalter „Stil 1 / Stil 2“ auf jeder Seite enthalten, und technisch sind sie nichts weiter als zwei Wertesätze für dieselben CSS-Variablen. Weder das Markup noch das CSS irgendeiner Komponente unterscheidet sich zwischen ihnen – jede Karte, jeder Button, jeder Abschnitt wechselt automatisch das Aussehen, je nachdem, welcher Variablensatz aktiv ist. Genau das ist der Lohn dafür, das Design von Anfang an aus solchen Variablen aufzubauen: Ein echter Kundenwunsch, der mit dem ursprünglichen Plan nichts zu tun hatte, kostete trotzdem null Umgestaltung – nur einen zweiten Wert pro Variable und einen Schalter. Das Navigationsskript ist dadurch etwas über sein selbst gesetztes Budget von 3 KB gerutscht – eine bewusste, gewünschte Ausnahme, kein schleichendes Ausufern.

Die Bildverarbeitung

Jedes Foto, das die Prüfung in Phase 0 bestanden hatte, lief durch ein wiederholbares Skript: responsive Breiten von 480, 960, 1600 und 2400 Pixeln, WebP mit JPEG als Rückfallebene, für jede Platzierung ein eigens gewählter Ausschnitt statt eines zentrierten Standards – das geparkte Auto oder der leere Himmel wurden herausgeschnitten, statt den Ausschnitt einfach irgendwo landen zu lassen. EXIF- und GPS-Daten wurden überall entfernt, Gesichter und Kennzeichen beschnitten oder unkenntlich gemacht. Ziel: kein einzelnes Bild über 250 KB.

Die echten Zahlen blieben darunter: Das größte Bild der fertigen Website hat 245 KB, und der gesamte erste Aufruf der Startseite – HTML, CSS, JS, ein Icon-Sprite, alle sieben selbst gehosteten Schriftdateien und das sofort geladene Hero-Bild – kommt auf etwa 305 KB. Den Großteil davon machen die Schriften aus, die nur einmal geladen und danach aus dem Cache genommen werden.

Wie das Bauen tatsächlich aussah

Eine einzige CSS-Datei, bewusst jedes Mal in derselben Reihenfolge aufgebaut – Variablen, dann Reset, dann Grundstile, Layout, Komponenten, Hilfsklassen, Media Queries –, damit sich keine Spezifitätskämpfe einschleichen, bei denen ein allgemeiner Element-Selektor und eine Komponentenklasse um dasselbe Padding ringen. Icons und das Trennmotiv zwischen den Abschnitten als handgeschriebenes Inline-SVG, durchgehend in einer einheitlichen Strichsprache, statt verschiedene Icon-Sets zu mischen.

Die Rechtsseiten wurden mit der echten Adresse des Kunden gebaut, mit [TBD]-Markierungen überall dort, wo nur ein Anwalt oder der Kunde selbst etwas eintragen kann – USt-IdNr., Eintrag bei der Handwerkskammer, Berufsbezeichnung –, dazu der ausdrückliche Hinweis, dass ein Anwalt beide Seiten prüfen muss, bevor irgendetwas online geht, egal wie vollständig sie aussehen. Dieselbe Disziplin beim Kontaktformular: vollständiges, funktionierendes Markup, ein Honeypot-Feld, eine Einwilligungs-Checkbox mit Link zur Datenschutzseite – und das action des Formulars als dokumentiertes [TBD], denn eine statische Demo hat noch kein Ziel, an das sie eine Anfrage tatsächlich zustellen könnte.

Zwei echte Bugs, die ein Browser fand und statische Prüfungen übersahen

In der Umgebung, in der das gebaut wurde, stand kein Headless-Browser zur Verfügung. Der eigentliche Prüfschritt bestand deshalb darin, einen echten Menschen zu bitten, die Website in einem echten Browser zu öffnen – und dabei kamen zwei Bugs ans Licht, die jede statische Prüfung übersehen hatte. Die Navigation im Kopfbereich verschwand bei Desktop-Breite komplett: Eine Technik aus <details> plus display: contents, die auf dem Papier vernünftig aussah, setzt das eingebaute Ausblenden des geschlossenen Zustands im Browser in Wirklichkeit nicht außer Kraft. Die Lösung: zurück zu einem einfachen, immer sichtbaren <nav>, das JavaScript erst unterhalb einer bestimmten Breite zu einem aufklappbaren Button mit Menü erweitert – sichtbar mit und ohne JS, bei jeder Breite. Außerdem wurden zwei Fotos auf einer Unterseite in einen Rahmen mit festem Seitenverhältnis gezwungen, der nicht zu ihrer tatsächlichen Form passte, sodass ein Streifen leerer Hintergrund sichtbar blieb. Ohne das erzwungene Verhältnis (und mit der Korrektur eines verwandten object-fit: cover-Fehlers, der überall, wo er verwendet wurde, stillschweigend gar nichts bewirkt hatte) zeigt jetzt jedes Foto seine echten Proportionen.

Das ist dasselbe Prinzip, das inzwischen auch auf der Experiment-Seite beschreibt, wie ich mit KI arbeite: KI entwirft und beschleunigt die Arbeit, aber nichts geht raus ohne eine echte menschliche Prüfung, die findet, was statische Analyse allein übersieht.

Der Rest der Selbstkritik verlief ruhiger, war aber genauso echt. Der W3C-Validator fand ein nicht kodiertes Leerzeichen in der Data-URI eines Inline-SVG-Favicons und ein paar übersprungene Überschriftenebenen – alle elf Seiten laufen jetzt ohne einen einzigen Fehler und ohne Warnung durch. Jede Kombination aus Text- und Hintergrundfarbe wurde geprüft, indem ich das tatsächliche WCAG-Kontrastverhältnis aus der relativen Leuchtdichte berechnet habe, statt nach Augenmaß zu urteilen; jede Kombination für Fließtext kam auf 6:1 oder besser, weit über dem Minimum von 4,5:1. Und alle 123 verschiedenen internen Links und Asset-Referenzen der Website wurden gegen einen lokalen Server abgerufen, um zu bestätigen, dass jede einzelne tatsächlich ankommt.

Was noch offen ist

Die meisten offenen Fragen des Kunden vom Anfang – wie genau der Firmenname erscheinen soll, der tatsächliche Einsatzradius, welche Telefonnummern genannt werden, wie die Website klar als Muster statt als echter Auftritt gekennzeichnet wird – haben sich unterwegs geklärt. Was tatsächlich noch offen ist und als offen markiert bleibt, statt stillschweigend angenommen zu werden: die Felder der Rechtsseiten, die auf die Prüfung durch einen Anwalt warten, ein Kontaktformular ohne Backend, weil ein statischer Server allein keine Mails versenden kann, und eine Platzhalter-Domain mit .example, bis es eine echte gibt.

Wenn Sie überlegen, ob sich eine richtig gebaute Website für Ihren eigenen Betrieb lohnt, erzählen Sie mir gern davon.

The anonymized sample site already in the portfolio, and the post about scrubbing it clean, both cover the same underlying project: a real pitch, built for a real metalworking and locksmithing business, that's still sitting private behind a password while they decide whether to go ahead. That post was about what got deleted before anything went public. This one is about the build itself — no names, no village, nothing that points back to anyone real, just how the thing actually got made.

Starting from a brief, not a blank page

Before writing a line of HTML, I wrote myself a brief: static site only, hand-written HTML and plain CSS, no framework, no build step, no CDN requests at runtime — self-host everything, because this is a German site and DSGVO makes that non-negotiable, not a nice-to-have. Never invent a fact — prices, certificates, opening hours, staff count, service radius, all of it only from what the client's own material actually supported. Anything missing gets logged as an open question and marked [TBD] in the HTML, never quietly papered over with confident-sounding filler.

Writing the constraints down first, before any design decision, is what keeps an AI-assisted build honest. It's much easier to catch "this doesn't belong on a real business's site" against a written rule than against a vague sense that something feels off.

Phase 0: look at every photo before deciding anything

The client had supplied a folder of real photos — the workshop, finished work, an owner portrait. Before any layout got sketched, every single one got opened and logged: pixel size, orientation, what's actually in the frame, described concretely enough to tell two similar shots apart, plus a quality rating from A (hero-capable) down to X (don't use — blurry, a stranger's face in frame, a visible number plate, a cluttered background). Anything that needed a number plate or a passer-by cropped out got flagged right there.

The rule that mattered most: only photos actually looked at could appear in the plan. If a section of the site had no real photo to back it, the section either got redesigned as pure type and line art, or it didn't exist — never a placeholder grey box waiting to be filled in later. Three pages with real content beat eight thin ones with stock-photo energy.

Rejecting the AI defaults

The design plan had to name an actual palette and typeface pairing before any CSS got written — and it had to explicitly reject a specific list of what I'd started calling "AI defaults": cream background with a high-contrast serif and a terracotta accent, near-black paired with acid green, a generic broadsheet look with hairline rules and zero border-radius anywhere, card grids with drop shadows as the entire visual idea, purple-to-blue gradients, icon fonts. All immediately recognizable, all the kind of thing that shows up by default when nobody's pushed back on the first plausible answer.

Instead the palette came from the trade's own material world — steel, the different finishes stainless steel actually takes, weathering, the stone the region is built from. Before presenting the plan, the gut-check question was: would I have produced this exact thing for any craftsman's website? Where the answer was yes, that part got changed.

A palette that changed after the client saw it

The material-derived palette was the plan. It wasn't the final word. After seeing it, the client asked for a second option sampled directly from their own workshop's physical signage — navy and white, nothing to do with the design brief's steel-and-stone logic, just what's already painted on their building.

Both palettes shipped as a "Stil 1 / Stil 2" switcher on every page, and technically they're nothing more than two sets of values for the same CSS custom properties. No component's markup or component-level CSS differs between them — every card, button, and section just re-skins automatically depending on which set of variables is active. That's the payoff of building the design as tokens from the start: a real client preference that had nothing to do with the original plan still cost zero redesign work, just a second value for each variable and a toggle. It did push the nav script a little over its own self-imposed 3 KB budget — a deliberate, requested exception, not scope quietly creeping.

The image pipeline

Every photo that made it past the Phase 0 review went through a repeatable script: responsive widths at 480, 960, 1600, and 2400 pixels, WebP with a JPEG fallback, art-directed crops per placement rather than a centered default — cutting out the parked car or the empty sky instead of just letting the crop fall wherever. EXIF and GPS data stripped from everything, faces and plates cropped or blurred out. Target: no single image over 250 KB.

The real numbers came in under that: the largest image on the finished site is 245 KB, and the homepage's entire first load — HTML, CSS, JS, an icon sprite, all seven self-hosted font files, and the eager-loaded hero image — comes to about 305 KB, most of which is the one-time, then-cached cost of the fonts.

What building actually looked like

One CSS file, deliberately structured in the same order every time — tokens, then reset, then base, layout, components, utilities, media queries — so specificity fights don't creep in between a generic element selector and a component class fighting over the same padding. Icons and the section-divider motif as hand-written inline SVG, kept to one consistent stroke language rather than mixing icon sets.

The legal pages got built against the client's real address, with [TBD] markers everywhere only a lawyer or the client themselves could actually fill in — VAT ID, trade chamber registration, professional title — plus an explicit note that a lawyer needs to review both pages before anything goes live, regardless of how complete they look. Same discipline on the contact form: full working markup, a honeypot field, a consent checkbox linking to the privacy page, and the form's action left as a documented [TBD], because a static demo has nowhere to actually deliver a submission yet.

Two real bugs a browser caught that static checks missed

No headless browser was available in the environment this got built in, so the actual verification step was asking a real person to open it in a real browser — and it caught two bugs that every static check had missed. The header navigation disappeared completely at desktop widths: a <details>-plus-display: contents technique that looked reasonable on paper doesn't actually override the browser's native closed-state hiding. Fixed by going back to a plain, always-visible <nav> that JavaScript progressively enhances into a collapsible button-and-menu only below a certain width — visible with or without JS, at every width. Two photos on one interior page were also getting forced into a fixed aspect-ratio frame that didn't match their actual shape, leaving a strip of visible empty background; removing the forced ratio (and, while in there, fixing a related object-fit: cover bug that had been silently doing nothing everywhere it was used) let each photo show at its own true proportions.

That's the same principle now written into how the site talks about AI-assisted work on the Experiment page: AI drafts and speeds the work up, but nothing ships without an actual human review catching what static analysis alone doesn't.

The rest of the self-critique pass was quieter but just as real. The W3C validator caught an unencoded space inside an inline SVG favicon's data URI and a few skipped heading levels — all eleven pages now run clean with zero errors and zero warnings. Every text-and-background color pairing got checked by computing the actual WCAG relative-luminance contrast ratio rather than eyeballing it; every body-text pairing came out at 6:1 or better, well past the 4.5:1 minimum. And all 123 unique internal links and asset references across the site got crawled against a local server to confirm every one actually resolves.

What's still open

Most of the client's open questions from early in the build — exactly how their business name should appear, their real service radius, which phone numbers to list, how to mark the site clearly as a sample rather than the real thing — got resolved along the way. What's genuinely still open, and stays marked as such rather than quietly assumed: the legal-page fields waiting on a lawyer's review, a contact form with no backend yet since a static host can't send mail on its own, and a placeholder .example domain standing in until there's a real one to point at.

If you're weighing whether your own business's site is worth building properly, I'd like to hear about it.

Hat Ihnen dieser Beitrag gefallen?

Ich freue mich über Ihr Feedback oder ein Gespräch über Ihr eigenes Projekt.

Kontakt aufnehmen