Repository navigation
1 Architecture
Oussama Elhadji edited this page Nov 7, 2026
·
1 revision
LKHODRA (الخضرة والغلة) is architected as an offline-first, client-rendered Progressive Web App (PWA) built with React 19, TypeScript 5.9, Vite 8, and Tailwind CSS v4, delivering sub-second filtering across 100+ botanical species, 12-month & 4-season organ chronobiology schedules, and 8 Moroccan agricultural terroirs.
flowchart TD
User([User in Moroccan Souk / Kitchen / Clinic]) --> UI[LKHODRA React 19 UI]
UI --> ChronoModule[4-Season & 12-Month Organ Chronobiology Deck]
UI --> CatalogModule[100+ Moroccan & World Produce Encyclopedia]
UI --> TerroirModule[8-Region Moroccan Agro-Climatic GIS Map]
UI --> HealthModule[9-Organ Clinical Bio-Apothecary Explorer]
UI --> QoffaModule[Souk Qoffa Budget & Macro Comparator]
UI --> SpeechModule[Darija & Amazigh Web Speech Synthesizer]
ChronoModule --> SeasonalDB[(seasonalOrgans.ts & monthlyOrgans.ts)]
CatalogModule --> ProduceDB[(produce.ts + verifiedProduceImages.ts)]
CatalogModule --> LocalImg[(108 Local Botanical Images /public/images/produce/)]
UI --> AgroAPIs[Live Agro-Botanical Telemetry: Open-Meteo / GBIF / OpenFoodFacts]
UI --> PWA[Workbox Service Worker Precache - 100% Offline Ready]
-
Color Tokens:
-
--bg-void:#050b07(Deep Nocturnal Oasis Obsidian) -
--bg-surface:#0a140e(Chlorophyll Herbarium Card Surface) -
--accent-emerald:#10b981/#34d399(Bioluminescent Chloroplast) -
--accent-saffron:#f59e0b(Taliouine Saffron Gold) -
--accent-ruby:#f43f5e(Sefri Pomegranate Ruby)
-
-
Arabic Cursive Typography Integrity:
- Uses
CairoandTajawalfor Arabic/Darija headlines and clinical copy alongsideSyne,Outfit,Fraunces, andJetBrains Monofor Latin/scientific telemetry. - Enforces
html[dir="rtl"] * { letter-spacing: 0 !important; font-feature-settings: "kern" 1, "liga" 1, "calt" 1; }so Arabic letters never disconnect or fragment.
- Uses
-
Zero-Overlap Herbarium Plate Layout (
src/components/ProduceCard.tsx):- Stacks the Weekly Schedule Badge, Target Weak Organ Title, and Clinical Explanation into dedicated full-width rows with
break-wordsso RTL/LTR text never collides on mobile or desktop viewports.
- Stacks the Weekly Schedule Badge, Target Weak Organ Title, and Clinical Explanation into dedicated full-width rows with
-
4-Season Mode: Maps
winter,spring,summer, andautumnto their climate-stressed organs and a 4-week seasonal recovery protocol. -
12-Month Mode: Maps every calendar month (
1January through12December) and its traditional Moroccan Fellahi solar period (الليالي, العزارة, الحسومة, نيسان, العنصرة, الصمايم, أكتوبر الفلاحي) to the primary and secondary vulnerable organs of that exact month and a 4-week monthly nutritional schedule.
- Queries the Wikipedia
pageimagesAPI and Wikimedia Commons API using each item's exact binomial scientific name (scientificName). - Downloads all 108 primary species images locally to
public/images/produce/<id>-1.jpgand generatessrc/data/verifiedProduceImages.tswith 3 non-repetitive photos per species and automaticonErrorlocal fallback.
LKHODRA (الخضرة والغلة) — The Definitive Moroccan & World Fruits, Vegetables & Organ Chronobiology Atlas
Curated & Architected by Oussama EL HADJI (@Bosaj) • Distributed under the MIT License
-
📖 Encyclopedia & Chronobiology
-
🍲 Culinary, Remedies & Souk Culture
-
🌐 Botanical APIs & Engineering