Communitygithub.com

xzedm/clipplic-landing - Material Design 3

Implementa o sistema de UI Material Design 3 (Material You) do Google. Primário: Jetpack Compose com Material3 (MaterialTheme, componentes, layout adaptativo). Também Flutter e web limitado (@material/web, modo de manutenção). Abrange tokens, 30+ componentes, layout, temas, M3 Expressive (matriz de plataforma) e acessibilidade.

O que é clipplic-landing - Material Design 3?

Esta skill permite implementar o sistema Material Design 3 (MD3) do Google, também conhecido como Material You, com foco principal no Jetpack Compose para Android. Ela fornece um guia completo para usar o tema Material3 (MaterialTheme), componentes como botões, cartões, barras de navegação, e sistemas de tokens de design (cores, tipografia, formas, elevação e movimento). A skill também cobre conceitos avançados como layout adaptativo com classes de tamanho de janela, o sistema de cores dinâmicas (Dynamic Color) e o modelo de física baseado em molas para animações. O suporte a Flutter é oferecido através da configuração useMaterial3: true no ThemeData, enquanto a implementação web via @material/web está em modo de manutenção e não inclui os recursos mais recentes do M3 Expressive. A documentação inclui uma árvore de decisão para orientar o desenvolvedor na escolha do scaffolding correto, uma referência rápida de 30 componentes categorizados, e links para arquivos detalhados sobre cada subsistema. A skill também diferencia as abordagens para diferentes plataformas, garantindo que o desenvolvedor siga as práticas recomendadas para cada ecossistema.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Material Design 3

Esta skill orienta a implementação do Material Design 3 (MD3) do Google — um sistema de design pessoal, adaptável e expressivo. O MD3 usa cor dinâmica, superfícies tonais, formas arredondadas e movimento baseado em molas para criar UIs que parecem vivas e pessoais.

Filosofia

O MD3 é construído sobre três princípios:

  • Pessoal: A cor dinâmica adapta a UI ao papel de parede ou conteúdo do usuário. A tematização é individual, não serve para todos.
  • Adaptável: Os layouts se transformam em 5 classes de tamanho de janela. Os componentes redimensionam, reposicionam e mudam de fator de forma de forma responsiva.
  • Expressivo: A morfologia de formas, a física de molas e a tipografia enfatizada criam momentos de deleite sem sacrificar a usabilidade.

Atualizações Atuais: Google I/O 2026

A atualização do Google I/O 2026 do Material reforça um caminho Compose-first para Android e expande a orientação expressiva/adaptativa:

  • Material Android é Compose-first: Para novos trabalhos em Android, prefira Jetpack Compose Material3 para os componentes mais recentes, APIs expressivas, scaffolds adaptativos e integração com Styles API. As Android Views podem permanecer necessárias em aplicativos existentes, mas não devem ser tratadas como o caminho padrão para novas implementações do Material 3.
  • Sistema de layout expressivo: Use um scaffold de layout expressivo para adaptar telas em dispositivos móveis, desktop, dobráveis, relógios, XR e outros fatores de forma espaciais. Comece a partir de scaffolds adaptativos/classes de tamanho de janela em vez de layouts fixos focados em telefone.
  • Sistema de espaçamento de 8dp: Aplique tokens de espaçamento para margens, preenchimento e lacunas para que layouts e componentes possam se adaptar programaticamente ao tipo de dispositivo e densidade.
  • Componentes expressivos novos/atualizados: Listas, menus, pesquisa e barras de aplicativo de pesquisa têm orientação expressiva renovada, com Jetpack Compose como o principal alvo de implementação.
  • Relógios e XR: Relógios enfatizam movimento baseado em física, texto em arco e contêineres que tocam as bordas. XR enfatiza painéis espaciais e elevação baseada em profundidade.

Principais diferenças do MD2:

  • Superfícies tonais substituem sombras de elevação como a principal dica de profundidade
  • A cor dinâmica gera esquemas completos a partir de uma única cor semente
  • Cantos completamente arredondados por padrão (não ligeiramente arredondados)
  • Física de movimento baseada em molas substitui curvas de suavização fixas para componentes
  • 3 níveis de contraste controlado pelo usuário (padrão/médio/alto)

Relação com a skill de design frontend: Quando ambas as skills estão ativas, o MD3 fornece o sistema de design (tokens, componentes, regras de layout) e o design frontend fornece direção criativa dentro dessas restrições. As regras do MD3 têm precedência para estrutura de componentes e uso de tokens. Nota: Roboto/Roboto Flex É a typeface padrão correta no MD3 — a orientação do design frontend para evitar Roboto não se aplica ao implementar MD3.

Árvore de Decisão

O que você está construindo?

Scaffold completo do app        → Veja "Padrões Comuns: App Shell" + referências/layout-and-responsive.md
Componente único                 → Veja "Referência Rápida de Componentes" tabela → referências/component-catalog.md
Tema personalizado               → Veja referências/theming-and-dynamic-color.md
Layout de formulário / entrada   → Veja referências/component-catalog.md § Input Components
Estrutura de navegação           → Veja referências/navigation-patterns.md
Exibição de dados                → Veja referências/component-catalog.md § Data Display

Qual plataforma?

Jetpack Compose          → Primário: androidx.compose.material3, MaterialTheme, referências/*
Flutter                  → useMaterial3: true in ThemeData, ColorScheme.fromSeed()
Web (vanilla JS)         → @material/web (limitado; modo de manutenção) + propriedades CSS customizadas
Web (React/Vue/Svelte)   → Propriedades CSS customizadas + componentes wrapper (sem biblioteca React oficial)
Web (CSS-only)           → Valores de token MD3 como propriedades CSS customizadas (sem elementos <md-*>)

Sistema de Tokens de Design

Todos os tokens MD3 usam o namespace md.sys. Jetpack Compose mapeia papéis para MaterialTheme.colorScheme, MaterialTheme.typography e MaterialTheme.shapes (mesmos papéis semânticos da especificação). Na web, estes mapeiam para propriedades CSS customizadas (--md-sys-*):

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

TokenPropósito
primaryPreenchimentos, texto, ícones de alta ênfase contra a superfície
on-primaryTexto/ícones em primary
primary-containerPreenchimento de destaque para componentes-chave (FAB, etc.)
on-primary-containerTexto/ícones em primary-container
secondary / on-secondaryDestaques menos proeminentes
secondary-container / on-secondary-containerComponentes recessivos (botões tonais)
tertiary / on-tertiaryDestaques contrastantes
tertiary-container / on-tertiary-containerContêineres complementares
error / on-errorEstados de erro (estático — não muda com a cor dinâmica)
error-container / on-error-containerPreenchimentos de contêiner de erro
surfaceFundo padrão
on-surfaceTexto/ícones em qualquer superfície
on-surface-variantTexto/ícones de menor ênfase na superfície
surface-container-lowestContêiner de menor ênfase
surface-container-lowContêiner de baixa ênfase
surface-containerContêiner padrão (áreas de navegação)
surface-container-highContêiner de alta ênfase
surface-container-highestContêiner de ênfase mais alta
surface-dim / surface-brightMantém o brilho relativo entre claro e escuro
inverse-surface / inverse-on-surface / inverse-primaryElementos contrastantes (snackbars)
outlineLimites importantes (bordas de campos de texto)
outline-variantElementos decorativos (divisores)

Detalhes completos: references/color-system.md

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

EscalaTamanhosUso
DisplayG / M / PTexto hero, números grandes
HeadlineG / M / PCabeçalhos de seção
TitleG / M / PCabeçalhos menores, títulos de cartão
BodyG / M / PTexto de parágrafo, descrições
LabelG / M / PBotões, chips, legendas

Cada estilo tem tokens para: -font, -weight, -size, -line-height, -tracking Além de 15 variantes enfatizadas (peso maior) via --md-sys-typescale-emphasized-*

Detalhes completos: references/typography-and-shape.md

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

TokenValorComponentes de exemplo
none0dp—
extra-small4dpChips, snackbars
small8dpCampos de texto, menus
medium12dpCartões
large16dpFABs, gaveta de navegação
large-increased20dp(Expressivo)
extra-large28dpDiálogos, bottom sheets
extra-large-increased32dp(Expressivo)
extra-extra-large48dp(Expressivo)
full9999pxBotões, chips, emblemas

Níveis de Elevação

NívelDPDeslocamento tonalUso
00dpNenhumSuperfícies planas, a maioria dos componentes em repouso
11dp+5% primaryCartões elevados, folhas modais
23dp+8% primaryMenus, barra de navegação, app bar rolada
36dp+11% primaryFAB, diálogos, pesquisa, seletores de data/hora
48dp+12% primary(aumento apenas em hover/foco)
512dp+14% primary(aumento apenas em hover/foco)

A elevação no MD3 é comunicada através da cor de superfície tonal, não de sombras. As sombras são usadas apenas quando necessário para proteção adicional contra fundos ocupados.

Movimento

O MD3 Expressivo (maio de 2025) introduziu física de movimento baseada em molas para componentes. O sistema legado de suavização/duração ainda é usado para transições (entrada/saída/eixo compartilhado):

SuavizaçãoDuraçãoTipo de transição
Enfatizada500msIniciar e terminar na tela
Enfatizada desacelerar400msEntrar na tela
Enfatizada acelerar200msSair da tela
Padrão300msIniciar e terminar na tela (utilitário)
Padrão desacelerar250msEntrar na tela (utilitário)
Padrão acelerar200msSair da tela (utilitário)

Valores CSS de suavização:

  • Enfatizada: cubic-bezier(0.2, 0, 0, 1)
  • Enfatizada desacelerar: cubic-bezier(0.05, 0.7, 0.1, 1)
  • Enfatizada acelerar: cubic-bezier(0.3, 0, 0.8, 0.15)
  • Padrão: cubic-bezier(0.2, 0, 0, 1)
  • Padrão desacelerar: cubic-bezier(0, 0, 0, 1)
  • Padrão acelerar: cubic-bezier(0.3, 0, 1, 1)

Referência Rápida de Componentes

ComponenteElemento WebVariantes PrincipaisCategoria
Botãomd-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-buttonPreenchido, Delineado, Texto, Elevado, Tonal; 5 tamanhos (PP–GG); alternarAções
Grupo de botõesmd-button-groupPadrão, conectadoAções
FAB estendidomd-extended-fabSuperfície, Primário, Secundário, TerciárioAções
FABmd-fabPequeno, Médio, GrandeAções
Menu FAB——Ações
Botão de íconemd-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-buttonPadrão, Preenchido, Preenchido Tonal, DelineadoAções
Botão segmentado—Seleção única, Seleção múltiplaAções
Botão dividido——Ações
Emblema—Pequeno (ponto), Grande (contagem)Comunicação
Indicador de carregamento—Linear, CircularComunicação
Indicador de progressomd-linear-progress, md-circular-progressLinear, Circular; determinado/indeterminadoComunicação
Snackbar—Única linha, Duas linhas, AçãoComunicação
Tooltip—Simples, RicoComunicação
Cartão—Preenchido, Delineado, ElevadoContenção
Carrossel—Navegação múltipla, Não contido, HeroContenção
Diálogomd-dialogBásico, Tela cheiaContenção
Bottom sheet—Padrão, ModalFolhas
Side sheet—Padrão, ModalFolhas
Divisormd-dividerLargura total, RecuadoContenção
Caixa de seleçãomd-checkbox—Entrada
Chipsmd-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chipAssistir, Filtrar, Entrada, SugestãoEntrada
Seletor de data—Acoplado, Modal, IntervaloEntrada
Menumd-menu, md-menu-item—Entrada
Botão de opçãomd-radio—Entrada
Controle deslizantemd-sliderContínuo, Discreto, IntervaloEntrada
Interruptormd-switchCom/sem íconeEntrada
Campo de textomd-filled-text-field, md-outlined-text-fieldPreenchido, DelineadoEntrada
Seletor de hora—Acoplado, ModalEntrada
App bar (superior)—Alinhado ao centro, Pequeno, Médio, GrandeNavegação
Barra de navegaçãomd-navigation-bar—Navegação
Gaveta de navegaçãomd-navigation-drawerPadrão, ModalNavegação
Trilho de navegação——Navegação
Pesquisa—Barra de pesquisa, Visualização de pesquisaNavegação
Abasmd-tabs, md-primary-tab, md-secondary-tabPrimário, SecundárioNavegação
Barra de ferramentas——Navegação
Listamd-list, md-list-itemUma linha, Duas linhas, Três linhasExibição de Dados

Nota: Componentes marcados com — para o elemento web ainda não têm implementações @material/web. Use propriedades CSS customizadas com HTML padrão para estes. Os mapeamentos e exemplos Compose estão em references/component-catalog.md.

Detalhes completos dos componentes com exemplos de código: references/component-catalog.md

Jetpack Compose (primário)

Use androidx.compose.material3 com MaterialTheme e composables do Material 3 (Scaffold, Button, NavigationBar, barras de aplicativo superiores, etc.).

  • Tematização: MaterialTheme(colorScheme = …, typography = …, shapes = …). Prefira dynamicLightColorScheme / dynamicDarkColorScheme no Android 12+ (API 31+) quando a cor dinâmica for desejada; caso contrário, use lightColorScheme / darkColorScheme ou código de tema gerado pelo Material Theme Builder.
  • UI Adaptativa: Classes de tamanho de janela, layouts lista-detalhe e painel de suporte, dobráveis — veja references/layout-and-responsive.md e references/navigation-patterns.md.
  • Borda a borda e insets: Disponha o conteúdo com WindowInsets / preenchimento do scaffold para que as barras e o IME se comportem corretamente — veja references/layout-and-responsive.md.
  • APIs Experimentais: Algumas APIs do Material 3 exigem @OptIn(ExperimentalMaterial3Api::class) ou opt-ins expressivos; corresponda ao seu BOM e compilador.
MaterialTheme(
    colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
    typography = Typography(),
    shapes = Shapes(),
) {
    // Conteúdo M3 — prefira referências para Scaffold, navegação, campos de texto
}

Web (limitado): @material/web

Importante: De acordo com o Material Design 3 para Web, os Componentes Web do Material estão em modo de manutenção e o M3 Expressive não está implementado na Web. Use @material/web para UIs web baseadas em tokens quando apropriado, mas não o trate como equivalente ao Compose para os recursos Expressivos atuais.

Configuração

npm install @material/web

Importar Componentes Individualmente

Sempre importe apenas os componentes que você usa — importar todo o pacote incha o bundle:

// Bom — importações individuais
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';

// Ruim — nunca faça isso
import '@material/web'; // importa tudo

Uso Básico

<!DOCTYPE html>
<html lang="pt">
<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>Começar</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)

Habilidades Relacionadas