system-prompts-and-models-o.../salesflow-saas/packages/design-system/README.md
Claude 40ab7b86c2
feat(dealix): Phase 1 completion + Phase 2 foundation scaffolded
PHASE 1 COMPLETION:

TASK-005 — Live gitleaks scan:
  Scanned 146 commits with gitleaks v8.20.1
  Result: 1 finding — FALSE POSITIVE (model name llama-3.1-70b-versatile
    in test fixture, not an API key)
  Added to .gitleaksignore
  rotation_log.md updated with scan results
  VERDICT: No real secrets in git history — repo clean for extraction

TASK-006 — Legal templates (bilingual):
  docs/legal/templates/IP_ASSIGNMENT_AGREEMENT.md — bilingual IP assignment
  docs/legal/templates/PRIVACY_POLICY_EN.md — PDPL/GDPR-aware template
  docs/legal/templates/PRIVACY_POLICY_AR.md — Arabic privacy policy
  docs/legal/templates/TERMS_OF_SERVICE_EN.md — SaaS ToS with MENA pricing
  docs/legal/templates/DPA_EN.md — Data Processing Agreement with annexes
  All marked as "DRAFT — must be reviewed by Saudi counsel before use"

TASK-006 — Trademark Filing Kit:
  docs/legal/templates/TRADEMARK_FILING_KIT.md
  Covers: DEALIX (Latin) + ديلكس (Arabic) + logo
  Classes 9, 42, 35 across KSA, UAE, Egypt, Jordan, Kuwait
  Application text ready to paste into SAIP + equivalents
  Agent recommendations (AGIP, Saba, Bird & Bird, Al Tamimi)
  Budget: ~90-120K SAR for full MENA coverage

Founder Decision Package:
  FOUNDER_DECISION_PACKAGE.md — single file with 4 decisions:
    1. GitHub org name (recommend: dealix-io)
    2. Entity structure (MISA vs DIFC vs ADGM)
    3. Saudi counsel engagement (15-30K SAR)
    4. Trademark filing (30-50K SAR initial)
  Total founder time to unblock: ~1 week + ~50K SAR

PHASE 2 FOUNDATION:

DEALIX_PHASE2_BLUEPRINT.md — 18-month category leadership plan:
  10 parallel streams (Frontend, Product, AI, Enterprise, Integrations,
    Scale, Commercial, Customer Platform, Trust, Category POV)
  Executable NOW vs Requires External Services vs Wait-for-PMF
  Phase 2 completion criteria (NPS >=50, NRR >=120%, etc.)

TASK-F201 — Design System foundation (scaffolded):
  packages/design-system/tokens/primitive.json — W3C Design Tokens format:
    Brand palette (50-900), neutral (50-950), critical/warning/success/info
    Space, radius, motion (duration + easing) tokens
    Typography with Arabic fontFamily + arabic-adjustment (1.15) for size
    Arabic line-height (1.8) for diacritics
  packages/design-system/tokens/semantic.json — light + dark themes:
    surface, fg, border, interactive, status semantic layers
  packages/design-system/README.md — principles + integration guide

TASK-CAT1340 (prep) — @dealix/arabic-ui package (scaffolded):
  packages/arabic-ui/src/normalize.ts:
    Diacritic-insensitive search (fatha/kasra/damma stripped)
    Hamza variants normalized (أ/إ/آ → ا)
    Waw-hamza, ya-hamza, taa-marbuta, alef-maksura handled
    arabicMatch() + arabicCompare() helpers
  packages/arabic-ui/src/numerals.ts:
    Western/Arabic-Indic/Eastern Arabic-Indic conversion
    formatCurrency() for SAR/AED/EGP/USD/JOD/KWD
    formatNumber() with locale awareness
  packages/arabic-ui/src/direction.ts:
    detectDirection() via Unicode bidi algorithm
    isolate() using U+2068/U+2069 for mixed-direction content
    isRTL() locale check
    hasArabic() presence check
  Future: release as OSS after 12 months of internal use

TASK-CAT1310 — Manifesto (bilingual draft):
  marketing/manifesto.md — 4 principles in Arabic + English:
    1. Arabic first, not Arabic translated
    2. Decisions backed by evidence, not opinion
    3. AI recommends, systems commit, humans approve
    4. Saudi compliance built-in, not bolted on
  Publication target: dealix.io/manifesto + dealix.io/بيان

TASK-CAT1320 — Dealix Labs (scaffolded):
  docs/labs/README.md — research program structure:
    Annual State of Arabic Enterprise AI report
    Quarterly Arabic LLM Benchmarks
    OTel semantic conventions proposal
    Open source: @dealix/arabic-ui + @dealix/design-system

TRUTH.yaml updated:
  Added Phase 2 capabilities section (all as 'partial' or 'roadmap')
  Added ISO 27001/17/18 and bug bounty to security_claims (all false)

All gates GREEN:
  Architecture Brief: 40/40
  Release Readiness Matrix: 71/71 (up from 53/53)
  Release Readiness Gate (blueprint): PASS
  Truth Registry Validator: VALID

https://claude.ai/code/session_01W1rJthWDkasijTdXCfxVHs
2026-04-17 10:52:28 +00:00

2.5 KiB

Dealix Design System

Status: Foundation scaffolded (Phase 2 TASK-F201)
Owner: Design + Frontend Platform team


Structure

packages/design-system/
├── tokens/
│   ├── primitive.json      # Raw values (colors, spacing, radius, motion, typography)
│   ├── semantic.json       # Intent-based (surface, fg, border, interactive, status)
│   └── component.json      # (future) Per-component tokens
├── primitives/             # (future) Button, Input, Card, Dialog
├── patterns/               # (future) ApprovalCard, EvidenceTimeline
├── layouts/                # (future) Shell, Split, Command
├── motion/                 # (future) Framer Motion variants
└── docs/                   # (future) Storybook stories

Token Design Principles

1. Primitive → Semantic → Component

Never reference primitives directly in components. Always go through semantic tokens.

// ❌ Wrong
<div style={{ color: 'hsl(var(--color-neutral-900))' }} />

// ✓ Right
<div style={{ color: 'hsl(var(--fg-primary))' }} />

2. Arabic adjustments are first-class

  • typography.fontSize.arabic-adjustment: multiply Latin sizes by 1.15 for Arabic
  • typography.lineHeight.arabic: 1.8 for diacritic-heavy text
  • Arabic font stack defaults to IBM Plex Sans Arabic with Tajawal fallback

3. Motion respects reduced-motion

Every motion token is used through utilities that check prefers-reduced-motion.

4. Dark mode is not a retrofit

Light + dark semantic layers defined in parallel in semantic.json.


Integration (Phase 2)

Once scaffolded:

  1. Install Style Dictionary: pnpm add -D style-dictionary
  2. Build tokens to CSS + TS: pnpm tokens:build
  3. Import in app: import '@dealix/design-system/tokens.css'

Standards

  • W3C Design Tokens Community Group format ($value, $type)
  • Tokens Studio compatible for Figma ↔ code round-trip
  • CSS custom properties output with -- prefix per theme

Phase 2 Roadmap

Task Status Notes
TASK-F201 — Tokens SCAFFOLDED primitive + semantic done
TASK-F210 — Typography Arabic-first type scale
TASK-F211 — RTL layout Logical CSS properties
TASK-F240 — Motion Framer Motion variants
TASK-F270 — ApprovalCard Signature pattern
TASK-F280 — Themes Light/dark/high-contrast/white-label

See DEALIX_PHASE2_BLUEPRINT.md for full roadmap.