# Qahera UI Kit (/llms.txt)
> Sovereign Egyptian & Regional AI-Native Design System and Canonical Component Architecture by Alwkala.

Qahera UI Kit is a high-craft, multi-target design system built on 15 normative invariants, authoritative YAML component contracts, semantic design tokens, and multi-runtime renderers (React 19 RSC, PHP 8.x Plates, W3C Web Components, HTML Native, and HTMX).

## Authority & Canonical Statistics (v1.5.2)
- **45 Canonical Components**: Form controls, overlays, navigation, data display, and 3 Egyptian heritage motifs (Cartouche, Frieze, Seal).
- **21 Composite UX Patterns**: Production-ready patterns including HeroSkylinePanorama, KanbanBoard, FileManagerGrid, and ChatStream.
- **20 Production Templates**: Complete application blueprints (Flagship Portal, Academic Executive, Admin, Wealth Telemetry, etc.).
- **46 Semantic SVG Icons**: Zero emoji policy; 100% semantic SVGs via `icons/registry.yaml`.
- **12 Cairo Neighborhood Themes**: Heliopolis Art Deco, Downtown Belle Époque, New Cairo Minimalist, Maadi Garden, Shubra Industrial, Zamalek Colonial, Garden City, Dokki Slate, Mokattam, Old Cairo, Nubia, Sinai Bedouin.
- **Strict Arabic Typography**: Alexandria for headings & display; Cairo for body copy; JetBrains Mono for code. Amiri is banned for UI components.
- **100% Logical CSS**: RTL as infrastructure (`margin-inline`, `padding-inline`, `inset-inline`). Zero physical left/right properties.
- **0kb RSC Footprint**: Pure React Server Components with `'use client'` strictly reserved for terminal interactive leaves.

## Public Canonical Routes
- [Landing Page](http://localhost/Qahera/): Sovereign platform overview and architectural philosophy.
- [Canonical Showcase](http://localhost/Qahera/showcase/): 86 canonical items (45 components + 21 patterns + 20 templates).
- [Theme Studio](http://localhost/Qahera/studio/): Interactive token customizer and live CSS export.
- [Documentation Portal](http://localhost/Qahera/docs/): Normative specification, tokens guide, and component contracts.
- [Components Catalog](http://localhost/Qahera/docs/components.html): 45 component contract guides and recipes.
- [Patterns Catalog](http://localhost/Qahera/docs/patterns.html): 21 composite patterns.
- [Application Templates](http://localhost/Qahera/templates/): 20 ready-to-use production application templates.
- [AI Decision Layer](http://localhost/Qahera/docs/ai-decision-layer.html): Guidance for AI coding agents and LLMs.
- [Full LLM Architecture Manifest](http://localhost/Qahera/llms-full.txt): Complete normative specification and contract registry.