Full-stack marketplace for Ethiopian entrepreneurs with Telegram bot
# Eyob Marketplace
A full-stack multi-vendor marketplace built for Ethiopian entrepreneurs.
## 🛠️ Tech Stack
- **Frontend**: React + Vite
- **Backend**: Node.js + Express + Prisma (SQLite)
- **Notifications**: Telegram Bot (Webhooks via Telegraf)
## 🚀 Local Development
### Prerequisites
- Node.js 18+
- Git
### Backend Setup
```bash
cd backend
cp .env.example .env # Fill in your values
npm install
npx prisma migrate dev # Create the local SQLite database
npm run dev # Starts on port 3000
```
### Frontend Setup
```bash
cd frontend
npm install
npm run dev # Starts on port 5173
```
## 📦 Environment Variables
See `backend/.env.example` for all required variables.
Key variables:
- `TELEGRAM_BOT_TOKEN` — From BotFather
- `TELEGRAM_BOT_USERNAME` — Your bot username
- `TELEGRAM_WEBHOOK_URL` — Your public HTTPS server URL + `/api/bot/webhook`
- `API_BASE_URL` — Your public backend URL (Railway/VPS)
- `SHOP_BASE_URL` — Your public frontend URL (Vercel)
## 🌐 Deployment
- **Backend** → Railway.app (free tier)
- **Frontend** → Vercel (free tier)
## 👤 Author
Eyob Wendmeneh — 2026