Communitygithub.com

brainzcode/premium-landing

Lizenzfreie, hochwertige Fotografie für eine Website von Unsplash – Suche nach Stimmung statt Nomen, Zuschnitt für den Platz, Einhaltung der API-Richtlinien und Erstellung echter Alt-Texte. Verwende dies, wenn eine Seite ein Hero-Bild, Abschnittsfotos, Avatare oder Kartenbilder benötigt und keine geliefert wurden; wenn graue Platzhalter durch echte Bilder ersetzt werden müssen; oder wenn du aufgefordert wirst, Fotos für ein Design zu finden, auszuwählen oder auszutauschen.

Was ist premium-landing?

Die Fähigkeit "brainzcode/premium-landing" bietet eine umfassende Lösung zur Integration von lizenzfreien, kommerziell nutzbaren Bildern von Unsplash in eine Webseite, wobei sie sich auf die Suche nach Stimmung und nicht nach konkreten Nomen konzentriert, um ein natürliches, nicht nach Vorlage aussehendes Ergebnis zu erzielen. Sie beschreibt detailliert, wie man einen kostenlosen API-Key erhält (50 Anfragen/Stunde), die beiden kritischen API-Regeln (Hotlinking der CDN-URLs und Auslösen des Download-Endpunkts für jede verwendete Bild) korrekt einhält und die Lizenzgrenzen einhält (keine unveränderten Kopien verkaufen, Modell- und Eigentumsfreigaben bei bedenklichen Inhalten beachten). Die Fähigkeit behandelt auch die optimale Auswahl von Bildern durch Suche nach der Stimmung (z. B. "warmer industrieller Arbeitsraum" statt "Kaffee"), die korrekte Größenanpassung mit Unsplash-CDN-Parametern (z. B. `?w=1600&q=80` für Heldenbilder), die Erstellung echter Alt-Texte (die das Bild beschreiben, nicht nur Schlagwörter) und eine Checkliste für die Implementierung. Sie ist für AI-Agenten konzipiert, die Landing Pages, Abschnitte oder Karten in Frameworks wie Claude Code, Cursor oder Codex erstellen, und stellt sicher, dass Bilder nicht brechen (da `source.unsplash.com` nicht mehr funktioniert) und die Bildsprache konsistent bleibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/stock-imagery

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Stockfotografie

Eine Landing Page mit einem grauen Platzhalter an der Stelle des Heldenbilds ist unvollständig. Dies behandelt die Beschaffung echter Fotografie, die kostenlos kommerziell nutzbar ist, zum Design passt und nicht kaputt geht, wenn jemand anderes die Seite lädt.

Der Endpunkt, den jeder zuerst versucht, ist tot

https://source.unsplash.com/1600x900/?coffee     →  HTTP 503

source.unsplash.com – der schlüssellose Zufallsbild-Endpunkt – wurde eingestellt. Er ist immer noch in Blogbeiträgen und älteren Vorlagen allgegenwärtig und gibt jetzt 503 zurück. Wenn du ihn in einem Codebase findest, ist das ein kaputtes Bild, kein funktionierendes.

Was schlüssellos funktioniert, ist das CDN, wenn du bereits eine Foto-ID kennst:

https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80

Das gibt ein echtes Bild zurück. Aber du kannst ohne Schlüssel nicht suchen, und das Erfinden von Foto-IDs funktioniert nicht. Also:

Einen Schlüssel bekommen (zwei Minuten, kostenlos)

  1. https://unsplash.com/oauth/applications → New Application → AGB akzeptieren
  2. Kopiere den Access Key
  3. Exportiere ihn – committe ihn niemals:
export UNSPLASH_ACCESS_KEY="your_access_key"

Der Demo-Tarif erlaubt 50 Anfragen/Stunde, was für eine Landing Page völlig ausreicht. Wenn der Benutzer keinen Schlüssel hat, sage es und frage – falle nicht stillschweigend auf graue Kästchen zurück und erfinde keine URLs.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "https://api.unsplash.com/search/photos?query=coastal+fog&orientation=landscape&per_page=8" \
| python3 -c "
import json,sys
for p in json.load(sys.stdin)['results']:
    print(p['id'], p['width'], p['height'], '|', (p.get('alt_description') or '')[:60])
    print('   ', p['urls']['raw'])
    print('   ', p['user']['name'], p['links']['download_location'])
"

Zwei API-Regeln, die leicht übersehen werden

1. Verwende die CDN-URLs, die die API zurückgibt. Die Nutzungsbedingungen der Unsplash-API verlangen die Verwendung ihrer CDN-URLs anstelle des erneuten Hostings der Datei. Das widerspricht der üblichen Empfehlung, lokal optimierte Assets auszuliefern, aber die Bedingungen haben Vorrang, solange du die API verwendest. Wenn ein Kunde selbst gehostete Dateien benötigt, lizenziere das Foto über Unsplash+ oder kaufe es woanders – hoste es nicht stillschweigend neu und hoffe auf das Beste.

2. Löse den Download-Endpunkt aus, wenn ein Foto tatsächlich verwendet wird. Nicht bei der Vorschau – sondern wenn es ausgeliefert wird. So erhalten Fotografen eine Nutzungsgutschrift, und es ist eine Bedingung der API, keine Höflichkeit.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "$DOWNLOAD_LOCATION"   # der Wert von links.download_location aus dem Suchergebnis

Lizenzgrenzen

Die Unsplash-Lizenz erlaubt die kommerzielle und nicht-kommerzielle Nutzung ohne Genehmigung und ohne erforderliche Namensnennung. Sie erlaubt nicht den Verkauf unveränderter Kopien, und sie erlaubt nicht den Aufbau eines konkurrierenden Fotodienstes. Fotos können identifizierbare Personen, Marken oder Kunstwerke enthalten – Unsplash klärt keine Modell- oder Eigentumsfreigaben, also verwende für alles, was eine Befürwortung impliziert (eine Person, die wie ein Kunde aussieht, ein Testimonial-Foto) ein Bild mit Freigabe.

Namensnennung ist nicht erforderlich, kostet aber eine Zeile und ist das Richtige:

<!-- Photo: Jane Doe / Unsplash -->

Gut auswählen

Die Suche nach dem wörtlichen Nomen lässt eine Seite wie eine Vorlage aussehen. "Kaffee" liefert zehntausend identische Latte-Art-Aufnahmen von oben.

Suche nach der Stimmung, nicht nach dem Motiv. Für eine Kaffeerösterei: warme Industriewerkstatt, arbeitende Hände, Innenraum mit Morgenlicht. Für eine Vermögensberatung: ruhige Architektur, ruhiges, minimales Interieur, lange Schatten.

Filtere dann nach drei Dingen, die das Design tatsächlich vorgibt:

  • Ausrichtung und Motivplatzierung. Ein Hero-Bild, das mit object-fit: cover beschnitten wird, benötigt das Motiv außermittig oder mit Kopfraum, sonst wird es dekapitiert. Überprüfe die Position des Motivs vor der Auswahl – die Rahmungsarithmetik steht in ../landing-page/references/traps.md.
  • Tonwertbereich. Überlagerter Text benötigt einen Bereich dahinter, der einheitlich hell oder einheitlich dunkel ist. Ein unruhiges Mitteltöne-Foto macht jede Textfarbe falsch.
  • Ein Fotograf oder ein Look. Drei Bilder von drei Fotografen in einem Abschnitt wirken wie Stock-Fotografie. Bevorzuge mehrere Bilder aus einem einzigen Shooting oder eine konsistente Farbgebung.

Größenanpassung

Unsplash-CDN-Parameter übernehmen die Größenänderung, also fordere die Größe an, die du anzeigst:

?auto=format&fit=crop&w=1600&q=80        hero
?auto=format&fit=crop&w=800&q=80         karte
?auto=format&fit=crop&w=192&h=192&q=80   avatar (quadratisch)

auto=format liefert WebP/AVIF an Browser, die es akzeptieren. Für responsive Hero-Bilder gib ein srcset mit 800/1200/1600/2000 aus, anstatt eine 2000px-Datei an Smartphones zu senden.

Alt-Text

alt beschreibt, was das Bild zeigt, für jemanden, der es nicht sehen kann. Es ist kein Keyword-Slot und nicht der Titel des Fotos.

<!-- nein -->
<img alt="Kaffeerösterei Landing Page Heldenbild">
<!-- ja -->
<img alt="Röster schüttet grüne Bohnen in einen Trommelröster in einer Werkstatt">

Wenn das Bild dekorativ ist und der umgebende Text bereits alles sagt, verwende alt="", damit ein Screenreader es überspringt. Ein leeres Alt ist korrekt; ein fehlendes Alt ist nicht korrekt.

Checkliste

  • UNSPLASH_ACCESS_KEY gesetzt, niemals committed
  • Nach der Stimmung gesucht, nicht nach dem wörtlichen Nomen
  • Motivplatzierung gegen den Zuschnitt des Slots geprüft
  • Tonwertbereich funktioniert unter jeglichem überlagerten Text
  • Bilder in einem Abschnitt teilen einen Look
  • CDN-URLs wie von der API verlangt verlinkt – nicht neu gehostet
  • download_location für jedes ausgelieferte Foto ausgelöst
  • Größenparameter passen zur Anzeigegröße; srcset bei responsiven Hero-Bildern
  • Echte Alt-Texte oder alt="" bei dekorativen Bildern
  • Keine Annahme von Modell-/Eigentumsfreigaben bei allem, was eine Befürwortung impliziert

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

Verwandte Skills