Ahmzyjazzy/ilorin-navigator

Ilorin Navigator is a Next.js web application that provides intelligent, AI-assisted navigation and points-of-interest (POI) recommendations for Ilorin, Nigeria using Gemini. It combines modern UI components, LLM-powered recommendation flows, and optional offline map features to deliver a helpful local navigation experience. # Ilorin Navigator Ilorin Navigator is a Next.js web application that provides intelligent, AI-assisted navigation and points-of-interest (POI) recommendations for Ilorin, Nigeria. It combines modern UI components, LLM-powered recommendation flows, and optional offline map features to deliver a helpful local navigation experience. This repository is a starter built with Next.js, Tailwind CSS, and GenKit for AI integrations. ## Quick links - Source: this repository - App entry: `src/app/page.tsx` - AI flows: `src/ai/flows` ## Features - Location input and destination search - Intelligent route optimization (LLM-assisted) - Nearby points of interest with ratings and brief details - AI-powered recommendations using GenKit flows - Design tokens and components with Tailwind CSS and Radix UI ## Screenshots Here are a couple of screenshots showing the app UI for the navigation and points-of-interest tabs. ### Navigation tab The navigation tab — enter origin and destination, get intelligent route suggestions and optimization options. ### Points of Interest (POI) tab List of nearby POIs with brief details, ratings, and quick actions. ## Tech stack - Next.js 15 - React 18 - TypeScript - Tailwind CSS - GenKit (AI flows) - Radix UI primitives - Firebase (client SDK included) ## Getting started Prerequisites - Node.js (recommended 18+) - pnpm (preferred) or npm/yarn Install dependencies ```bash pnpm install ``` Run in development ```bash pnpm dev ``` Open localhost in your browser (the dev server uses port 9002 by default). GenKit (AI) developer flows The repository includes GenKit flows under `src/ai/flows`. During development you can run GenKit with the included helper scripts: ```bash pnpm genkit:dev # run GenKit developer server (uses src/ai/dev.ts) pnpm genkit:watch # run GenKit in watch mode ``` Build and production ```bash pnpm build pnpm start ``` Other useful scripts - `pnpm lint` — run Next.js ESLint config - `pnpm t …