Gods-path/ndongo-ai

# NDONGO AI — The Living Kingdom **Preserving African Heritage Through Artificial Intelligence** A premium, production-ready web application built for an AI innovation competition: an interactive digital kingdom that teaches the history of the Kingdom of Ndongo, Queen Nzinga, and Mbundu culture through an AI historian, interactive storytelling, timelines, maps, a museum gallery, and quizzes. --- ## 1. Folder Structure ``` src/ app/ Next.js App Router pages page.tsx Landing page (hero, features, stats, Nzinga, AI vision) chat/ Feature 1 — AI Heritage Chat story/ Feature 2 — Story Mode timeline/ Feature 3 — Interactive Timeline culture/ Feature 4 — Culture Explorer map/ Feature 5 — Historical Map gallery/ Feature 6 — Museum Gallery quiz/ Feature 7 — AI Quiz team/ Feature 9 — Meet the Team api/ chat/route.ts Streaming chat endpoint (Vercel AI SDK) quiz/route.ts AI-generated quiz endpoint (with static fallback) layout.tsx Root layout: fonts, theme, presentation mode, nav/footer globals.css Design tokens, African pattern, animations components/ ui/ Hand-built shadcn-style primitives (button, card, dialog, ...) layout/ Navbar, footer, theme toggle, presentation mode controls home/ Landing page sections chat/ story/ timeline/ culture/ map/ gallery/ quiz/ team/ Feature-specific components data/ Local JSON "knowledge base" (see below) lib/ ai/ System prompt, retrieval, model provider site-config.ts Site metadata + nav links presentation-mode-context.tsx utils.ts cn() class helper ``` ## 2. How to Install Dependencies ```bash npm install ``` ## 3. Environment Variables Copy `.env.example` to `.env.local` and fill in what you need: …