folajindayo/ghana-names

# 🇬🇭 Ghanaian Name Generator A Web3-powered application that generates authentic Ghanaian names with cultural meaning, stores them on IPFS, and links them to your wallet address. *Built with Next.js, WalletConnect, MongoDB, and Pinata IPFS* ## ✨ Features - **🌍 Authentic Ghanaian Names**: Generate names from Akan, Ewe, Ga, Dagomba, and Fante traditions - **🤖 AI-Powered Generation**: Contextual name generation using OpenAI (optional) - **💼 WalletConnect Integration**: Connect your Web3 wallet to claim names - **🔗 IPFS Storage**: All claimed names are permanently stored on IPFS via Pinata - **📊 MongoDB Persistence**: Store name cards, transactions, and user profiles (optional) - **🔍 Explore & Share**: Browse all claimed names and share your name cards - **📜 Transaction History**: Complete audit trail of all name-related actions - **🎁 Name Gifting**: Transfer name ownership to other wallet addresses ## 🚀 Getting Started ### Prerequisites - Node.js 18+ and npm/pnpm - MongoDB Atlas account (or local MongoDB instance) for full functionality - Pinata account for IPFS storage - Reown/WalletConnect Project ID - OpenAI API key (optional, for AI-powered generation) ### Installation 1. Clone the repository: ```bash git clone github.com cd ghana-names ``` 2. Install dependencies: ```bash npm install # or pnpm install ``` 3. Configure environment variables in `.env.local`: ```env # MongoDB Connection (use MongoDB Atlas or local instance for development) MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net # Pinata IPFS PINATA_API_KEY=your_pinata_api_key PINATA_API_SECRET=your_pinata_api_secret PINATA_JWT=your_pinata_jwt_token # Reown/WalletConnect Project ID NEXT_PUBLIC_REOWN_PROJECT_ID=your_reown_project_id # OpenAI API (optional, for AI-powered generation) OPENAI_API_KEY=your_openai_api_key ``` 4. Run the development server: ```bash npm run dev # or pnpm dev ``` 5. Open localhost in your …