# Helpio 🤝

A decentralized Q&A platform built on the Celo blockchain where knowledge meets rewards. Ask questions, provide answers, and earn points for your contributions to the community.

## 🌟 Overview

Helpio is a gamified question-and-answer platform that leverages blockchain technology to reward users for sharing knowledge. Every question asked and answer provided earns you points on the Celo blockchain, creating a fair and transparent reputation system.

## ✨ Features

- **Ask Questions**: Post questions about any topic and get help from the community
- **Provide Answers**: Share your knowledge and expertise with others
- **Best Answer Selection**: Question askers can select the most helpful answer
- **Blockchain Rewards**: Earn points for every question and answer on Celo blockchain
- **Gamified Experience**: Build your reputation through a transparent point system
- **Decentralized**: All points and activities are recorded on-chain for transparency
- **Community-Driven**: Users collectively build a knowledge base through their contributions

## 🚀 Tech Stack

- **Frontend**: React + TypeScript + Vite
- **Styling**: Tailwind CSS
- **Blockchain**: Celo Network
- **Smart Contracts**: Solidity
- **Database**: Supabase
- **Web3**: Thirdweb SDK

## 📦 Installation

1. **Clone the repository**
   ```bash
   git clone https://github.com/DeshaDev/Helpio.git
   cd Helpio
   ```

2. **Install dependencies**
   ```bash
   npm install
   ```

3. **Set up environment variables**
   
   Create a `.env` file in the root directory:
   ```env
   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_key
   VITE_THIRDWEB_CLIENT_ID=your_thirdweb_client_id
   ```

4. **Run the development server**
   ```bash
   npm run dev
   ```

## 🎮 How It Works

1. **Connect Wallet**: Users connect their Celo wallet to get started
2. **Ask Questions**: Post questions and earn points when submitted
3. **Answer Questions**: Browse questions and provide helpful answers to earn points
4. **Select Best Answer**: Question askers choose the most helpful answer
5. **Earn Rewards**: Points are automatically credited to your wallet on-chain
6. **Build Reputation**: Accumulate points to build your community reputation

## 📝 Smart Contract

The platform uses a custom smart contract deployed on Celo that handles:
- Point distribution for questions and answers
- Best answer rewards
- User reputation tracking
- Transparent point history

## 🎯 Point System

- **Ask a Question**: Earn points for contributing questions
- **Provide an Answer**: Earn points for helping others
- **Best Answer Selected**: Receive bonus points when your answer is chosen

## 🛠️ Development

```bash
# Run development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

# Lint code
npm run lint
```

## 📄 Project Structure

```
Helpio/
├── contracts/          # Smart contracts
├── src/
│   ├── components/    # React components
│   ├── hooks/         # Custom React hooks
│   ├── lib/           # Utility functions
│   ├── contexts/      # React contexts
│   └── config/        # Configuration files
├── supabase/          # Database migrations and functions
└── public/            # Static assets
```

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📜 License

This project is licensed under the MIT License.

## 👥 Team

Built with ❤️ by DeshaDev

---

**Helpio** - Empowering knowledge sharing through blockchain technology 🚀