Skip to content

ogc16/ePay

Repository files navigation

💳 ePay – Ecommerce Mobile App

Expo License: MIT PRs Welcome Made with Love GitHub Stars GitHub Forks Last Commit Issues Pull Requests

---

A cross-platform ecommerce mobile app built with React Native and Expo, designed for seamless shopping, secure payments, and efficient order management.
Optimized for retail businesses in emerging markets, ePay offers a fast, reliable, and scalable mobile commerce solution.


✨ Features

  • 🛍️ Product browsing with categories, search, and filters
  • 🛒 Shopping cart & checkout with real-time price updates
  • 🚚 Order tracking and status notifications
  • 💳 Mobile payments via integrated gateways
  • 🔐 User authentication & profile management
  • 📊 Admin dashboard for inventory and orders (optional)

🧰 Tech Stack

  • ⚛️ React Native + Expo (cross-platform development)
  • 🛣️ Expo Router (navigation)
  • 🔥 Firebase / Supabase (or custom backend integration)
  • 🔐 Secure storage & payment modules
  • 🌐 Web browser integration for payments

📦 Installation

Clone the repository and install dependencies:

git clone https://github.com/ogc16/epay.git
cd epay
npm install   # or pnpm install

📱 Running the App

npx expo start

Scan the QR code with Expo Go App

Or run on Android/iOS emulator

⚙️ Configuration

Create a .env file in the root directory:

API_URL=https://your-api.com
PAYMENT_KEY=your_payment_gateway_key

🚀 Deployment

Build with Expo Application Services (EAS):

eas build --platform android

Then distribute via:

  • Google Play Store (Android)

  • Apple App Store (iOS)

(Update app.json with app name, icons, and credentials before publishing.)

🤝 Contributing

Contributions are welcome! 🎉

  • Fork the repo

  • Create a feature branch (git checkout -b feature-name)

  • Commit changes (git commit -m "Add feature")

  • Push and open a pull request

For major changes, please open an issue first to discuss your ideas.

📄 License

MIT License © 2025 Caleb Ngeno