Skip to Content
Design

Guia de Design Qokit

Contrato de design público voltado para integração de plataforma, desenvolvimento de extensões e uso de componentes.

Qokit Design GuidePublic components, tokens & integrationQokit 设计指南公共组件、设计令牌与平台集成Qokit 設計指南公開元件、設計權杖與平台整合Guía de diseño de QokitComponentes públicos, tokens e integraciónQokit DesignleitfadenÖffentliche Komponenten, Tokens und IntegrationGuide de conception QokitComposants publics, jetons et intégrationGuia de design QokitComponentes públicos, tokens e integraçãoQokit デザインガイド公開コンポーネント、トークン、統合Qokit 디자인 가이드공개 컴포넌트, 토큰 및 통합Guida al design QokitComponenti pubblici, token e integrazioneQokit-ontwerpgidsPublieke componenten, tokens en integratiePanduan Desain QokitKomponen publik, token, dan integrasiHướng dẫn thiết kế QokitThành phần công khai, token và tích hợpQokit Tasarım RehberiHerkese açık bileşenler, tokenlar ve entegrasyonGuia de design QokitComponentes públicos, tokens e integraçãoГайд по дизайну QokitПубличные компоненты, токены и интеграцияدليل تصميم Qokitمكوّنات عامة ورموز تصميم وتكاملQokit डिज़ाइन गाइडसार्वजनिक कॉम्पोनेंट, टोकन और इंटीग्रेशनคู่มือการออกแบบ Qokitคอมโพเนนต์สาธารณะ โทเค็น และการผสานรวมPrzewodnik projektowy QokitPubliczne komponenty, tokeny i integracja

Guia de Design do Qokit

O Guia de Design do Qokit destina-se a futuros integradores da plataforma, desenvolvedores de extensões e equipes front-end, explicando publicamente o que pode ser confiável a longo prazo: fundamentos da marca, interfaces de componentes, hierarquia visual, requisitos de responsividade e estratégias de compatibilidade.

Aqui descrevemos "no que os desenvolvedores podem confiar", sem incluir rotas internas de produto, prompts de IA, processos de decisão do repositório ou soluções de implementação não públicas.

Integração Rápida

import { Button, Card } from '@qokit/components/ui';
import { platformButtonSkin, platformCardSkin } from '@qokit/components/skins/platform';

export function IntegrationAction() {
  return (
    <Card layer="shell" skin={platformCardSkin}>
      <Button skin={platformButtonSkin} type="button" variant="primary">
        连接 Qokit
      </Button>
    </Card>
  );
}

Ao integrar, selecione as capacidades na seguinte ordem:

  1. Selecione componentes básicos como Button, Card e Dialog em @qokit/components/ui;
  2. Selecione combinações de produtos estáveis em @qokit/components/patterns;
  3. Utilize @qokit/components/skins/platform, site ou admin para adaptar à interface alvo;
  4. Use Tokens CSS compartilhados, não copie estilos base dos componentes;
  5. Valide nos estados desktop, mobile, teclado e textos longos.

Mapa do Guia

O que precisa saberDocumento
Cores da marca, fontes, espaçamentos e Tokensfoundations.md
Responsividade, teclado e acessibilidadeaccessibility.md
Importação de componentes, contrato público Skeleton/Skin e métodos de atualizaçãocomponent-integration.md
Button e IconButtonbutton-component-rules.md
Card, Shell, sobreposições e materiaiscard-surface-materials.md
Padrões de qualidade públicos para sites geradosgenerated-site-quality.md
Mudanças no contrato e registro de atualizaçõeschangelog.md

Contrato Público

  • A estrutura do componente, atributos e comportamento de acessibilidade são mantidos pelo componente compartilhado;
  • Skin altera apenas slots de class e variáveis CSS, não altera o comportamento de negócios;
  • Tokens semânticos mantêm a mesma responsabilidade em temas claros, escuros e de sites gerados;
  • Alterações breaking devem ser registradas no Changelog, com instruções de migração fornecidas;
  • Quando houver divergência entre documentação e código, prevalece a API do componente publicado, e a documentação deve ser corrigida na mesma versão.

Nesta página