Huthkid01/USSD-Directory

The Ultimate USSD Directory for Africa| Access thousands of network codes for Airtime, Data, Banking, and more across the continent. Fast, offline-ready, and always up-to-date. ## USSD Directory Africa USSD Directory Africa is a React + Vite web app that lets users quickly find, search and filter USSD codes for mobile networks and banks across multiple African countries. It focuses on real-world use cases like checking airtime balance, buying data, mobile money, and bank USSD banking codes. ## Tech Stack - React 18 - Vite - React Router - Tailwind CSS - Axios (for loading local JSON data) - react-helmet-async (SEO metadata) - lucide-react (icons) ## Getting Started ### Prerequisites - Node.js 18+ (recommended) - npm (comes with Node) ### Install dependencies ```bash npm install ``` ### Run in development ```bash npm run dev ``` Then open the URL shown in the terminal (usually localhost). ### Build for production ```bash npm run build ``` The production-ready files will be in the `dist` folder. You can preview the production build locally with: ```bash npm run preview ``` ## Available Scripts - `npm run dev` – start Vite dev server - `npm run build` – build the app for production - `npm run preview` – preview the built app - `npm run lint` – run ESLint (requires an ESLint config if you add one) ## Project Structure - `src/` - `pages/` - `HomePage.jsx` – landing page, search, popular and recent codes, submit-code popup - `CountryPage.jsx` – codes filtered by country, with copy and dial actions - `NetworkPage.jsx` – codes filtered by provider, grouped by category - `AboutPage.jsx`, `PrivacyPage.jsx`, `TermsPage.jsx`, `DisclaimerPage.jsx` – static info and legal pages - `components/` - `layout/Header.jsx` – top navigation, submit-code button - `layout/Footer.jsx` – footer, disclaimer, LinkedIn credit link - `USSDCard.jsx` – card used in code grids - `SEO.jsx` – reusable SEO/meta component - `ScrollToTop.jsx` – scroll to top on route change - `hooks/useUSSDData.js` – loads and prepares USSD data - `utils/countryUtils.js` – helpers for mapping country names to flag codes - `public/ussd_data.json` – main data sour …