Communitygithub.com

brainzcode/premium-landing

Source libre, photographies sans licence pour un site depuis Unsplash — en cherchant par ambiance plutôt que par nom, en dimensionnant et recadrant pour l'emplacement, en respectant les exigences de hotlink et de suivi des téléchargements de l'API, et en écrivant un vrai texte alternatif. À utiliser quand une page a besoin d'une image hero, de photos de section, d'avatars ou d'illustrations de carte et qu'aucune n'a été fournie ; quand les gris de remplacement doivent être remplacés par des images réelles ; ou quand on vous demande de trouver, choisir ou échanger des photos pour un design.

Qu'est-ce que premium-landing ?

Cette compétence fournit un guide complet pour intégrer des photographies d'Unsplash dans des pages web, en évitant les pièges courants comme l'utilisation d'endpoints obsolètes. Elle explique comment obtenir une clé API gratuite, effectuer des recherches par ambiance plutôt que par nom, et respecter les conditions d'utilisation d'Unsplash (hotlinking des URL CDN, déclenchement de l'endpoint de téléchargement). La compétence détaille également le dimensionnement approprié des images via les paramètres CDN, l'écriture de texte alternatif réel (alt), et les limites de licence pour les photos comportant des personnes ou des marques. Elle est utile pour les développeurs et designers créant des pages d'atterrissage, des portfolios, ou tout site nécessitant des images libres de droits, et est compatible avec tout environnement utilisant des requêtes HTTP (curl, fetch, etc.).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Imagerie libre de droits

Une page d'accueil avec un espace réservé gris à l'endroit où devrait se trouver l'image hero est inachevée. Ceci couvre la recherche de photographies réelles, gratuites pour un usage commercial, correspondant au design, et qui ne cassent pas lorsque quelqu'un d'autre charge la page.

Le point de terminaison que tout le monde essaie d'abord est mort

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

source.unsplash.com — le point de terminaison d'image aléatoire sans clé — a été supprimé. On le trouve encore partout dans des articles de blog et des modèles plus anciens, et il renvoie désormais 503. Si vous le trouvez dans une base de code, c'est une image cassée, pas une image fonctionnelle.

Ce qui fonctionne, sans clé, c'est le CDN quand vous connaissez déjà un identifiant de photo :

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

Cela renvoie une image réelle. Mais vous ne pouvez pas rechercher sans clé, et inventer des identifiants de photo ne fonctionne pas. Donc :

Obtenir une clé (deux minutes, gratuit)

  1. https://unsplash.com/oauth/applications → Nouvelle Application → acceptez les conditions
  2. Copiez la Clé d'accès
  3. Exportez-la — ne la commitez jamais :
export UNSPLASH_ACCESS_KEY="votre_clé_d_accès"

Le niveau démo est de 50 requêtes/heure, ce qui est amplement suffisant pour une page d'accueil. Si l'utilisateur n'a pas de clé, dites-le et demandez — ne revenez pas silencieusement à des boîtes grises et n'inventez pas d'URL.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "https://api.unsplash.com/search/photos?query=brouillard+côtier&orientation=paysage&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'])
"

Deux règles de l'API faciles à oublier

1. Hotlinkez les URL renvoyées par l'API. Les conditions d'utilisation de l'API Unsplash exigent l'utilisation de leurs URL CDN plutôt que de ré-héberger le fichier. Cela entre en conflit avec le conseil habituel de servir des actifs optimisés localement, et les conditions prévalent tant que vous utilisez l'API. Si un client a besoin de fichiers hébergés localement, achetez une licence pour la photo via Unsplash+ ou ailleurs — ne ré-hébergez pas discrètement en espérant que cela passe.

2. Déclenchez le point de terminaison de téléchargement lorsqu'une photo est réellement utilisée. Pas quand elle est prévisualisée — quand elle est livrée. C'est ainsi que les photographes reçoivent du crédit pour l'utilisation, et c'est une condition de l'API, pas une courtoisie.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "$EMPLACEMENT_TÉLÉCHARGEMENT"   # la valeur links.download_location du résultat de recherche

Limites de licence

La licence Unsplash autorise une utilisation commerciale et non commerciale sans autorisation et sans attribution requise. Elle n'autorise pas la vente de copies non modifiées, et elle n'autorise pas la construction d'un service de photos concurrent. Les photos peuvent contenir des personnes identifiables, des marques ou des œuvres d'art — Unsplash ne fournit pas de libération de modèle ou de propriété, donc pour tout ce qui implique une approbation (une personne semblant être un client, une photo de témoignage) utilisez plutôt une image avec une libération.

L'attribution n'est pas requise mais ne coûte qu'une ligne et est la bonne chose à faire :

<!-- Photo : Jeanne Dupont / Unsplash -->

Bien choisir

Rechercher le nom littéral est ce qui donne à une page l'air d'un modèle. "Café" renvoie dix mille photos identiques de latte art vu de dessus.

Recherchez l'ambiance, pas le sujet. Pour une torréfaction de café : atelier industriel chaleureux, mains au travail, intérieur lumière matinale. Pour un conseil en gestion de patrimoine : architecture calme, intérieur minimaliste silencieux, ombres longues.

Filtrez ensuite sur trois choses que le design contraint réellement :

  • Orientation et placement du sujet. Un hero qui recadre avec object-fit: cover nécessite que le sujet soit décentré ou avec de l'espace au-dessus, sinon le recadrage le décapite. Vérifiez où se trouve le sujet avant de choisir — l'arithmétique du cadrage se trouve dans ../landing-page/references/traps.md.
  • Gamme tonale. Le texte superposé nécessite que la zone derrière lui soit uniformément claire ou uniformément sombre. Une photo occupée aux tons moyens rend toute couleur de texte incorrecte.
  • Un seul photographe, ou un seul look. Trois images de trois photographes dans une même section donnent l'impression d'être libres de droits. Préférez plusieurs vues d'une même séance, ou une gradation cohérente.

Dimensionnement

Les paramètres du CDN Unsplash effectuent le redimensionnement, donc demandez la taille que vous affichez :

?auto=format&fit=crop&w=1600&q=80        hero
?auto=format&fit=crop&w=800&q=80         carte
?auto=format&fit=crop&w=192&h=192&q=80   avatar (carré)

auto=format sert WebP/AVIF aux navigateurs qui l'acceptent. Pour les images hero responsives, émettez un srcset à 800/1200/1600/2000 plutôt que d'envoyer un seul fichier de 2000px aux téléphones.

Texte alternatif

alt décrit ce que l'image montre, pour quelqu'un qui ne peut pas la voir. Ce n'est pas un emplacement pour mots-clés ni le titre de la photo.

<!-- non -->
<img alt="image hero page d'accueil torréfaction café">
<!-- oui -->
<img alt="Torréfacteur versant des grains verts dans un torréfacteur à tambour dans un atelier">

Si l'image est décorative et que le texte environnant dit déjà tout, utilisez alt="" pour qu'un lecteur d'écran la saute. Un alt vide est correct ; un alt manquant ne l'est pas.

Liste de vérification

  • UNSPLASH_ACCESS_KEY définie, jamais commitée
  • Recherche de l'ambiance, pas du nom littéral
  • Placement du sujet vérifié par rapport au recadrage de l'emplacement
  • Gamme tonale fonctionne sous tout texte superposé
  • Les images d'une même section partagent un look
  • URL CDN hotlinkées comme l'API l'exige — pas ré-hébergées
  • download_location déclenché pour chaque photo livrée
  • Paramètres de dimensionnement correspondent à la taille d'affichage ; srcset sur les images hero responsives
  • Texte alternatif réel, ou alt="" quand décoratif
  • Aucune hypothèse de libération de modèle/propriété pour quoi que ce soit impliquant une approbation

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.

Skills associés