folajindayo/ghana-names
Domain:
natural language processingRecord type:
software
Creator:
fol
Host:
# 🇬🇭 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 …