Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

ADR-013: Design register — Modal / Resend / Stripe / Linear / Vercel; no AI visual tells

Status: CURRENT Date: 2026-05-16

Context

Generated UI was defaulting to glow halos, emoji bullets, gradient backgrounds, micro-bounce animations, and the recognizable “AI aesthetic”. The result reads as machine-output and is alien to the CPaaS register Orbit is trying to occupy.

Decision

Quiet, dense, monochrome-plus-accent register matching Modal, Resend, Stripe, Linear, and Vercel. Tokens: nebula-*, signal-teal, text-primary. Component conventions: forwardRef plus cva plus cn() plus kebab-case.tsx. Imports: @devotel/ui/* subpaths only, never @/components/ui/*. No emojis. No micro-bounces. No glow halos.

Reason

Brand differentiation. Serious-tool credibility. Reduces the “AI smell” that erodes user trust on a paid CPaaS.

Consequences

  • .claude/skills/orbit-ui/SKILL.md is mandatory pre-read for any .tsx edit under apps/web, apps/admin, apps/landing, or packages/ui.
  • [[scan_ai_visual_tells_2026_05_13]] is the audit baseline.
  • The design-tokens package is canonical.
  • New components must match the register.

Source memos

  • [[project_design_overhaul]]
  • .claude/skills/orbit-ui/SKILL.md
  • [[design_system_foundation]]
  • [[scan_ai_visual_tells_2026_05_13]]