Communitygithub.com

xzedm/clipplic-landing

Implémente le système d'interface utilisateur Material Design 3 (Material You) de Google. Principalement pour Jetpack Compose, également Flutter et Web limité.

Qu'est-ce que clipplic-landing ?

Cette compétence guide l'implémentation de Material Design 3 (MD3), le système de design personnel, adaptatif et expressif de Google. Elle fournit des instructions complètes pour les tokens de design (couleur, typographie, formes, élévation et mouvement), plus de 30 composants d'interface (boutons, champs de texte, cartes, barres de navigation, etc.), et des modèles de mise en page adaptative. La plateforme principale est Jetpack Compose avec `androidx.compose.material3`, mais la compétence couvre également Flutter (via `useMaterial3: true`) et le Web via `@material/web` (en mode maintenance, sans les fonctionnalités expressives). Elle inclut les dernières mises à jour du Google I/O 2026, comme le passage au Compose-first pour Android, le système de spacing 8dp, et l'accent mis sur les montres et la XR. Les développeurs sont guidés à travers un arbre de décision pour identifier les composants appropriés, les plateformes et les ressources de référence, avec des exemples de code et des tableaux de référence détaillés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/material-3

Demander à votre IA préférée

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

Documentation

Material Design 3

Cette compétence guide l'implémentation de Material Design 3 (MD3) de Google — un système de design personnel, adaptatif et expressif. MD3 utilise la couleur dynamique, les surfaces tonales, les formes arrondies et le mouvement basé sur des ressorts pour créer des interfaces qui semblent vivantes et personnelles.

Philosophie

MD3 repose sur trois principes :

  • Personnel : La couleur dynamique adapte l'interface au fond d'écran ou au contenu de l'utilisateur. Le thème est individuel, pas universel.
  • Adaptatif : Les mises en page se transforment à travers 5 classes de taille de fenêtre. Les composants se redimensionnent, se repositionnent et changent de facteur de forme de manière réactive.
  • Expressif : La morphing des formes, la physique des ressorts et la typographie accentuée créent des moments de plaisir sans sacrifier la convivialité.

Mises à jour actuelles : Google I/O 2026

La mise à jour Google I/O 2026 de Material renforce une voie Compose-first pour Android et élargit les directives expressives/adaptatives :

  • Material Android est Compose-first : Pour tout nouveau travail Android, privilégiez Jetpack Compose Material3 pour les derniers composants, les API expressives, les échafaudages adaptatifs et l'intégration de l'API Styles. Les Android Views peuvent rester nécessaires dans les applications existantes, mais ne doivent pas être considérées comme le chemin par défaut pour les nouvelles implémentations Material 3.
  • Système de mise en page expressive : Utilisez un échafaudage de mise en page expressive pour adapter les écrans sur mobile, desktop, pliables, montres, XR et autres facteurs de forme spatiaux. Commencez par des échafaudages adaptatifs/classes de taille de fenêtre plutôt que des mises en page fixes centrées sur le téléphone.
  • Système d'espacement 8dp : Appliquez des tokens d'espacement pour les marges, le padding et les espaces afin que les mises en page et les composants puissent s'adapter par programme au type d'appareil et à la densité.
  • Composants expressifs nouveaux/mis à jour : Les listes, menus, recherche et barres d'application de recherche ont des directives expressives actualisées, avec Jetpack Compose comme cible d'implémentation principale.
  • Montres et XR : Les montres mettent l'accent sur les mouvements basés sur la physique, le texte en arc et les conteneurs épousant les bords. La XR met l'accent sur les panneaux spatiaux et l'élévation basée sur la profondeur.

Différences clés avec MD2 :

  • Les surfaces tonales remplacent les ombres d'élévation comme principal indicateur de profondeur
  • La couleur dynamique génère des schémas complets à partir d'une seule couleur source
  • Coins entièrement arrondis par défaut (pas légèrement arrondis)
  • La physique de mouvement basée sur des ressorts remplace les courbes d'assouplissement fixes pour les composants
  • 3 niveaux de contraste contrôlés par l'utilisateur (standard/moyen/élevé)

Relation avec la compétence frontend-design : Lorsque les deux compétences sont actives, MD3 fournit le système de design (tokens, composants, règles de mise en page) et frontend-design fournit la direction créative dans ces contraintes. Les règles MD3 prévalent pour la structure des composants et l'utilisation des tokens. Remarque : Roboto/Roboto Flex EST la police par défaut correcte dans MD3 — la directive frontend-design d'éviter Roboto ne s'applique pas lors de l'implémentation de MD3.

Arbre de décision

Que construisez-vous ?

Échafaudage complet d'application    → Voir "Modèles courants : Shell d'application" + references/layout-and-responsive.md
Composant unique                      → Voir "Référence rapide des composants" tableau → references/component-catalog.md
Thème personnalisé                   → Voir references/theming-and-dynamic-color.md
Formulaire / mise en page de saisie   → Voir references/component-catalog.md § Input Components
Structure de navigation              → Voir references/navigation-patterns.md
Affichage de données                 → Voir references/component-catalog.md § Data Display

Quelle plateforme ?

Jetpack Compose          → Principal : androidx.compose.material3, MaterialTheme, references/*
Flutter                  → useMaterial3: true dans ThemeData, ColorScheme.fromSeed()
Web (vanilla JS)         → @material/web (limité ; mode maintenance) + propriétés personnalisées CSS
Web (React/Vue/Svelte)   → Propriétés personnalisées CSS + composants wrapper (pas de bibliothèque React officielle)
Web (CSS uniquement)     → Valeurs des tokens MD3 comme propriétés personnalisées CSS (pas d'éléments <md-*>)

Système de tokens de design

Tous les tokens MD3 utilisent l'espace de noms md.sys. Jetpack Compose mappe les rôles vers MaterialTheme.colorScheme, MaterialTheme.typography et MaterialTheme.shapes (mêmes rôles sémantiques que la spécification). Sur le Web, ils sont mappés vers des propriétés personnalisées CSS (--md-sys-*) :

Tokens de couleur (--md-sys-color-*)

TokenObjectif
primaryRemplissages à haute emphase, texte, icônes sur la surface
on-primaryTexte/icônes sur primary
primary-containerRemplissage distinctif pour les composants clés (FAB, etc.)
on-primary-containerTexte/icônes sur primary-container
secondary / on-secondaryAccents moins importants
secondary-container / on-secondary-containerComposants récessifs (boutons tonals)
tertiary / on-tertiaryAccents contrastants
tertiary-container / on-tertiary-containerConteneurs complémentaires
error / on-errorÉtats d'erreur (statiques — ne changent pas avec la couleur dynamique)
error-container / on-error-containerRemplissages des conteneurs d'erreur
surfaceArrière-plan par défaut
on-surfaceTexte/icônes sur toute surface
on-surface-variantTexte/icônes à emphase réduite sur la surface
surface-container-lowestConteneur à emphase la plus basse
surface-container-lowConteneur à faible emphase
surface-containerConteneur par défaut (zones de navigation)
surface-container-highConteneur à haute emphase
surface-container-highestConteneur à emphase la plus haute
surface-dim / surface-brightMaintiennent la luminosité relative entre clair et sombre
inverse-surface / inverse-on-surface / inverse-primaryÉléments contrastants (snackbars)
outlineLimites importantes (bordures de champ de texte)
outline-variantÉléments décoratifs (séparateurs)

Détails complets : references/color-system.md

Tokens de typographie (--md-sys-typescale-*)

ÉchelleTaillesUtilisation
DisplayL / M / STexte héro, grands nombres
HeadlineL / M / SEn-têtes de section
TitleL / M / SEn-têtes plus petits, titres de cartes
BodyL / M / STexte de paragraphe, descriptions
LabelL / M / SBoutons, chips, légendes

Chaque style a des tokens pour : -font, -weight, -size, -line-height, -tracking Plus 15 variantes accentuées (poids plus élevé) via --md-sys-typescale-emphasized-*

Détails complets : references/typography-and-shape.md

Tokens de forme (--md-sys-shape-corner-*)

TokenValeurExemples de composants
none0dp—
extra-small4dpChips, snackbars
small8dpChamps de texte, menus
medium12dpCartes
large16dpFABs, tiroir de navigation
large-increased20dp(Expressif)
extra-large28dpBoîtes de dialogue, feuilles inférieures
extra-large-increased32dp(Expressif)
extra-extra-large48dp(Expressif)
full9999pxBoutons, chips, badges

Niveaux d'élévation

NiveauDPDécalage tonalUtilisation
00dpAucunSurfaces planes, la plupart des composants au repos
11dp+5% primaryCartes surélevées, feuilles modales
23dp+8% primaryMenus, barre de navigation, barre d'application défilée
36dp+11% primaryFAB, boîtes de dialogue, recherche, sélecteurs de date/heure
48dp+12% primary(augmentation au survol/focus uniquement)
512dp+14% primary(augmentation au survol/focus uniquement)

L'élévation dans MD3 est communiquée par la couleur de surface tonale, pas par les ombres. Les ombres ne sont utilisées que lorsque nécessaire pour une protection supplémentaire contre les arrière-plans chargés.

Mouvement

MD3 Expressif (mai 2025) a introduit la physique de mouvement basée sur des ressorts pour les composants. Le système hérité d'assouplissement/durée est encore utilisé pour les transitions (entrée/sortie/axe partagé) :

AssouplissementDuréeType de transition
Accentué500msDébut et fin à l'écran
Accentué décéléré400msEntrée à l'écran
Accentué accéléré200msSortie de l'écran
Standard300msDébut et fin à l'écran (utilitaire)
Standard décéléré250msEntrée à l'écran (utilitaire)
Standard accéléré200msSortie de l'écran (utilitaire)

Valeurs d'assouplissement CSS :

  • Accentué : cubic-bezier(0.2, 0, 0, 1)
  • Accentué décéléré : cubic-bezier(0.05, 0.7, 0.1, 1)
  • Accentué accéléré : cubic-bezier(0.3, 0, 0.8, 0.15)
  • Standard : cubic-bezier(0.2, 0, 0, 1)
  • Standard décéléré : cubic-bezier(0, 0, 0, 1)
  • Standard accéléré : cubic-bezier(0.3, 0, 1, 1)

Référence rapide des composants

ComposantÉlément WebVariantes clésCatégorie
Boutonmd-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-buttonRempli, Contour, Texte, Surélevé, Tonal ; 5 tailles (XS–XL) ; basculeActions
Groupe de boutonsmd-button-groupStandard, connectéActions
FAB étendumd-extended-fabSurface, Primaire, Secondaire, TertiaireActions
FABmd-fabPetit, Moyen, GrandActions
Menu FAB——Actions
Bouton icônemd-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-buttonStandard, Rempli, Tonal Rempli, ContourActions
Bouton segmenté—Sélection unique, Sélection multipleActions
Bouton partagé——Actions
Badge—Petit (point), Grand (nombre)Communication
Indicateur de chargement—Linéaire, CirculaireCommunication
Indicateur de progressionmd-linear-progress, md-circular-progressLinéaire, Circulaire ; déterminé/indéterminéCommunication
Snackbar—Ligne unique, Deux lignes, ActionCommunication
Infobulle—Simple, RicheCommunication
Carte—Remplie, Contour, SurélevéeContenant
Carrousel—Multi-parcours, Non contenu, HéroContenant
Boîte de dialoguemd-dialogBasique, Plein écranContenant
Feuille inférieure—Standard, ModaleFeuilles
Feuille latérale—Standard, ModaleFeuilles
Séparateurmd-dividerPleine largeur, EncartContenant
Case à cochermd-checkbox—Saisie
Chipsmd-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chipAssistance, Filtre, Saisie, SuggestionSaisie
Sélecteur de date—Ancré, Modale, PlageSaisie
Menumd-menu, md-menu-item—Saisie
Bouton radiomd-radio—Saisie
Curseurmd-sliderContinu, Discret, PlageSaisie
Interrupteurmd-switchAvec/sans icôneSaisie
Champ de textemd-filled-text-field, md-outlined-text-fieldRempli, ContourSaisie
Sélecteur d'heure—Ancré, ModaleSaisie
Barre d'application (haut)—Centrée, Petite, Moyenne, GrandeNavigation
Barre de navigationmd-navigation-bar—Navigation
Tiroir de navigationmd-navigation-drawerStandard, ModaleNavigation
Rail de navigation——Navigation
Recherche—Barre de recherche, Vue de rechercheNavigation
Ongletsmd-tabs, md-primary-tab, md-secondary-tabPrimaire, SecondaireNavigation
Barre d'outils——Navigation
Listemd-list, md-list-itemUne ligne, Deux lignes, Trois lignesAffichage de données

Remarque : Les composants marqués avec — pour l'élément Web n'ont pas encore d'implémentations @material/web. Utilisez des propriétés personnalisées CSS avec du HTML standard pour ces composants. Les mappages et exemples Compose se trouvent dans references/component-catalog.md.

Détails complets des composants avec exemples de code : references/component-catalog.md

Jetpack Compose (principal)

Utilisez androidx.compose.material3 avec MaterialTheme et les composables Material 3 (Scaffold, Button, NavigationBar, barres d'application supérieures, etc.).

  • Thématisation : MaterialTheme(colorScheme = …, typography = …, shapes = …). Préférez dynamicLightColorScheme / dynamicDarkColorScheme sur Android 12+ (API 31+) lorsque la couleur dynamique est souhaitée ; sinon lightColorScheme / darkColorScheme ou le code de thème généré à partir de Material Theme Builder.
  • UI adaptative : Classes de taille de fenêtre, mises en page liste-détail et volet de support, pliables — voir references/layout-and-responsive.md et references/navigation-patterns.md.
  • Bord à bord et encarts : Disposez le contenu avec WindowInsets / le padding de l'échafaudage pour que les barres et l'IME se comportent correctement — voir references/layout-and-responsive.md.
  • API expérimentales : Certaines API Material 3 nécessitent @OptIn(ExperimentalMaterial3Api::class) ou des opt-ins expressifs ; faites correspondre votre BOM et votre compilateur.
MaterialTheme(
    colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
    typography = Typography(),
    shapes = Shapes(),
) {
    // Contenu M3 — préférez les références pour Scaffold, navigation, champs de texte
}

Web (limité) : @material/web

Important : Selon Material Design 3 pour le Web, les composants Web Material sont en mode maintenance et M3 Expressif n'est pas implémenté sur le Web. Utilisez @material/web pour les interfaces Web basées sur des tokens lorsque cela est approprié, mais ne le traitez pas comme équivalent à Compose pour les fonctionnalités expressives actuelles.

Configuration

npm install @material/web

Importer les composants individuellement

Importez toujours uniquement les composants que vous utilisez — importer l'ensemble du package gonfle le bundle :

// Bien — importations individuelles
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';

// Mal — ne faites jamais cela
import '@material/web'; // importe tout

Utilisation de base

<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
  <md-filled-button>Commencer</md-filled-button>
  <md-outlined-text-field label="Email" type="email"></md-outlined-text-field>

  <script type="module">
    import '@material/web/button/filled-button.js';
    import '@material/web/textfield/outlined-text-field.js';
  </script>
</body>
</html>

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

Skills associés