BelleCash/nigeria-school-navigator

A mobile-first web application designed to navigate Nigeria’s educational landscape across 774 LGAs. Built during a 30-day intensive sprint, this project focuses on high-performance data filtering, ES6+ architecture, and AI-assisted "Vibe Coding" optimized for 3G/4G network conditions. # 🇳🇬 Nigeria School Navigator ### 30-Day Expertise Sprint: From Intent to Architecture A high-performance, mobile-first search engine designed to navigate the educational landscape across all 774 Local Government Areas (LGAs) in Nigeria. This project is the result of a disciplined 30-day "Expertise Sprint," focusing on efficient data handling for low-bandwidth environments and AI-assisted "Vibe Coding" workflows. --- ## 🎯 The Mission To build a lightweight, scalable solution for locating schools nationwide. This project prioritizes: * **Mobile-First Performance:** Optimized for 3G/4G stability and fast load times. * **Data Strategy:** Efficiently filtering the Humanitarian Data Exchange (HDX) Nigeria school dataset. * **Vibe Coding:** Leveraging AI tools like Cursor and v0.dev for rapid, intent-based development. --- ## 🗓️ The 30-Day Roadmap | Phase | Focus Area | Milestone | | :--- | :--- | :--- | | **Week 1** | Web Foundations | Semantic HTML5 and CSS Grid layout for school listing cards. | | **Week 2** | JS & REST | Async logic to filter nationwide data by State and LGA. | | **Week 3** | React Frameworks | Building the search interface and results grid using React. | | **Week 4** | AI & Leadership | "Smart Recommendation" chat and final Vercel deployment. | --- ## 🏗️ Project Architecture ### Data Strategy Handling data for a country as large as Nigeria requires a performance-first approach. We use a "fetch-and-filter" logic to ensure the UI remains snappy, even when parsing thousands of data points from the HDX dataset. ### Tech Stack * **Frontend:** React (Vite) * **Styling:** CSS Grid and Flexbox (Custom optimized for mobile) * **Data Source:** Humanitarian Data Exchange (HDX) * **AI Tools:** Cursor (Pair Programming), v0.dev (UI Generation) * **Deployment:** Vercel --- ## 🚀 Getting Started 1. **Clone the repository** ```bash git clone github.com Explore the Phases Each week's progress is organized int …