{
  "schemaVersion": 1,
  "name": "VendePay Design System",
  "language": "pt-BR",
  "lastVerified": "2026-08-26",
  "canonicalUrl": "https://design.vendepay.com.br",
  "currentReferenceUrl": "https://design.vendepay.com.br/current",
  "repository": "https://github.com/Vendepay-Org/nova-vendepay-ux",
  "sourcePriority": [
    "Executable code, contracts, migrations and tests",
    "Implemented frontend design-system tokens and components",
    "Living UX documentation at /current and in nova-vendepay-ux",
    "Historical June 2026 .dc.html artifacts"
  ],
  "historicalContentPolicy": {
    "paths": ["/viewer", "/artifacts"],
    "status": "historical-snapshot",
    "instruction": "Do not implement historical artifacts literally. Resolve divergences against executable code and the living reference."
  },
  "stack": {
    "ui": "React 19",
    "language": "TypeScript",
    "styles": "vanilla-extract",
    "primitives": "Base UI",
    "icons": "Lucide",
    "titleFont": "Poppins",
    "bodyFont": "Open Sans"
  },
  "tokens": {
    "colors": {
      "brand": "#04D361",
      "brandBright": "#0BF372",
      "accentLight": "#049366",
      "deepTeal": "#00454C",
      "light": {
        "background": "#F8F9FA",
        "surface": "#FFFFFF",
        "surface2": "#F2F4F7",
        "textPrimary": "#212529",
        "textSecondary": "#495057",
        "textTertiary": "#667085",
        "border": "#E6E9EF"
      },
      "dark": {
        "background": "#070707",
        "surface": "#101010",
        "surface2": "#16161A",
        "textPrimary": "#E1E1E6",
        "textSecondary": "#A8A8B3",
        "textTertiary": "#8A8A96",
        "border": "#29292E"
      }
    },
    "spacePx": [4, 8, 12, 16, 24, 32, 48, 64],
    "radiusPx": {"small": 8, "control": 10, "card": 12, "large": 16, "pill": 999},
    "motionMs": {"fast": 150, "base": 250, "slow": 350},
    "minimumTouchTargetPx": 44
  },
  "saleStatuses": [
    {"enum": "PENDING", "label": "Pendente", "family": "awaiting"},
    {"enum": "PAID", "label": "Paga", "family": "success"},
    {"enum": "FAILED", "label": "Recusada", "family": "closed"},
    {"enum": "REFUND_REQUESTED", "label": "Aguardando reembolso", "family": "awaiting"},
    {"enum": "REFUNDED", "label": "Estorno", "family": "informative"},
    {"enum": "CHARGED_BACK", "label": "Chargeback", "family": "closed"}
  ],
  "derivedSalePresentations": [
    "Reembolso parcial",
    "Reembolso de chargeback",
    "Disputa ganha",
    "Assinatura encerrada",
    "Situação mista"
  ],
  "currentProduct": {
    "product": {
      "primaryOfferLimit": 1,
      "primaryPlanLimit": 1,
      "minimumBaseCurrencyPrice": 10,
      "statementDescriptorRequired": true,
      "editorSteps": ["Básico", "Recursos", "Preço", "Funil", "Afiliados", "Links"],
      "tracking": ["Meta", "TikTok", "Google Ads", "UTMify"]
    },
    "checkout": {
      "primaryCheckoutLimit": 1,
      "primaryStyleLimit": 1,
      "displayName": "Checkout principal",
      "styleName": "Estilo principal",
      "globalPricing": "dynamic-conversion-from-base-price",
      "manualPricePerCurrency": false,
      "previewLanguageCount": 12,
      "compatibilityDebt": "Internal checkouts[] and create endpoint remain but do not define the user experience."
    },
    "withdrawal": {
      "flowCount": 1,
      "mode": "manual-on-request",
      "destinations": ["PIX", "crypto-base"],
      "providerNeutral": true,
      "balanceBuckets": ["Disponível", "A liberar", "Reservado", "Em envio"],
      "eligibilityGates": ["KYC", "debt", "open-withdrawal"],
      "fees": {"spreadPercent": 2, "iofPercentForBrlDestination": 3.5, "fixedFeeBrlEquivalent": 4.99}
    },
    "kyc": {
      "unified": true,
      "profiles": ["PF", "PJ", "PEP"],
      "documentUpload": true,
      "gates": ["selling", "payout"]
    },
    "paymentAvailabilityRule": "Distinguish backend/runtime capability from availability exposed in the seller UI."
  },
  "components": {
    "base": ["Button", "Card", "Input", "TextField", "Select", "Toggle", "SegmentedControl", "Chip", "Tooltip"],
    "feedback": ["Banner", "StatusBadge", "Skeleton", "EmptyState", "ErrorState", "Toaster", "FieldFeedback"],
    "data": ["MoneyValue", "CurrencyField", "PercentageField", "DateField", "DateRangeField", "FilterToolbar", "SearchField"],
    "layout": ["AppShell", "Drawer", "FocusEditor", "StepTrail", "StatCard", "LoadMore"]
  },
  "artifacts": [
    {"slug": "indice-original", "title": "Índice original", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=indice-original", "currentUrl": "https://design.vendepay.com.br/current#fontes"},
    {"slug": "identidade-visual", "title": "Manual de Identidade Visual", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=identidade-visual", "currentUrl": "https://design.vendepay.com.br/current#fundamentos"},
    {"slug": "status-sinalizacao", "title": "Manual de Status e Sinalização", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=status-sinalizacao", "currentUrl": "https://design.vendepay.com.br/current#vendas"},
    {"slug": "arquitetura-mapa", "title": "Arquitetura e Mapa", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=arquitetura-mapa", "currentUrl": "https://design.vendepay.com.br/current#operacao"},
    {"slug": "modo-foco", "title": "Modo Foco", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=modo-foco", "currentUrl": "https://design.vendepay.com.br/current#padroes"},
    {"slug": "app-vendepay", "title": "App VendePay", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=app-vendepay", "currentUrl": "https://design.vendepay.com.br/current#operacao"},
    {"slug": "entrada-kyc", "title": "Entrada e KYC", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=entrada-kyc", "currentUrl": "https://design.vendepay.com.br/current#kyc"},
    {"slug": "produto", "title": "Editor de Produto", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=produto", "currentUrl": "https://design.vendepay.com.br/current#produto"},
    {"slug": "checkout-builder", "title": "Checkout Builder", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=checkout-builder", "currentUrl": "https://design.vendepay.com.br/current#checkout"},
    {"slug": "saldos-saque", "title": "Saldos e Saque", "status": "historical", "url": "https://design.vendepay.com.br/viewer?artifact=saldos-saque", "currentUrl": "https://design.vendepay.com.br/current#financeiro"}
  ],
  "agentEndpoints": {
    "quick": "https://design.vendepay.com.br/llms.txt",
    "full": "https://design.vendepay.com.br/llms-full.txt",
    "context": "https://design.vendepay.com.br/ai/context.md",
    "structured": "https://design.vendepay.com.br/ai/design-system.json",
    "humanCurrent": "https://design.vendepay.com.br/current"
  },
  "synchronizationTriggers": [
    "design tokens",
    "shared components or states",
    "navigation and responsive behavior",
    "status presentation",
    "structural copy",
    "financial mental models",
    "major user flows"
  ]
}