a decentralized commerce ecosystem built to empower African entrepreneurs, creators, and traders through blockchain technology. By leveraging Web3 tools and smart contracts, the platform enables secure peer-to-peer transactions, NFT-based product listings, and tokenized loyalty systems—connecting communities across borders without intermediaries.
# African Trade Empire - Stacks Integration
This README outlines how the African Trade Empire application has been enhanced with Bitcoin ecosystem cryptocurrencies (BTC, STX, and sBTC) through integration with the Stacks blockchain.
## Overview
African Trade Empire is a blockchain-based trading simulation game that now incorporates Stacks wallet connectivity and a crypto trading minigame. The application simulates trading routes across Africa while leveraging Bitcoin ecosystem tokens.
## Features
### Wallet Integration
- Connect with Stacks wallets (Leather and Xverse)
- Authenticate users through their Bitcoin or Stacks credentials
- View wallet balances and history
- Withdraw earned tokens directly to connected wallets
### Crypto Caravan Game
- Trade Bitcoin ecosystem assets (BTC, STX, sBTC) across global crypto hubs
- Strategic trading simulation with market price differences
- Earn real crypto rewards through gameplay
- Withdraw earned assets to your personal wallet
### Technical Implementations
- Stacks Connect integration for wallet authentication
- React-based game interfaces
- Responsive design for all devices
- Framer Motion animations for smooth user experience
## Setup and Installation
1. Clone the repository:
```bash
git clone
github.com
cd africa-trade-empire
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Add required Stacks dependencies:
```bash
npm install @stacks/connect @stacks/transactions
```
4. Create `.env.local` file with configuration:
```
NEXT_PUBLIC_STACKS_NETWORK=testnet
```
5. Start the development server:
```bash
npm run dev
# or
yarn dev
```
## Project Structure
```
├── components/
│ ├── layout/
│ │ └── Navbar.js # Navigation with wallet connection
│ ├── games/
│ │ ├── NFTTradingGame.js # Original card-based game
│ │ └── CaravanRoutesGame.js # Crypto trading simulation
│ └── ui/ # Reusable UI components …