Skip to content

Welcome to Kuza Market – a modern digital platform connecting Sellers and buyers across College! πŸ‡°πŸ‡ͺ Whether you're selling second hand goods or buying them Kuza Market simplifies everything. βœ¨πŸ“²

Notifications You must be signed in to change notification settings

lewiii254/uni-market-finds

Repository files navigation

πŸš€ Kuza Market - College🏫 MarketPlaceπŸ›’

Welcome to Kuza Market – a modern digital platform connecting Sellers and buyers across College! πŸ‡°πŸ‡ͺ Whether you're selling second hand goods or buying them Kuza Market simplifies everything. βœ¨πŸ“²


✨ Features

πŸ‘©β€πŸ’Ό Admin Panel

  • πŸ” Secure Admin Login
  • πŸ§‘ Manage Users & Profiles
  • πŸ“¦ Product Listing Oversight
  • 🚨 Handle Reports

πŸ‘€ User Profile

  • βœ… Sign Up / Login
  • 🧾 Add and Manage Listings
  • πŸ“Έ Profile Customization
  • πŸ’¬ Chat via WhatsApp or Email

πŸ›’ Marketplace

  • πŸ₯¬ Explore Second Hand Products
  • πŸ“ Filter by Category / Location
  • πŸ“¨ Contact via WhatsApp or Email (No in-app transactions yet!)
  • ❀️ Wishlist

πŸ› οΈ Getting Started

You can work locally in your favorite IDE, use GitHub Codespaces, or even edit directly on GitHub!


βœ… Use Your Preferred IDE

The only requirement is having Node.js & npm installed (we recommend installing via nvm).

Follow these steps:

# Step 1: Clone the repository
git clone https://github.com/your-username/kuza-market.git

# Step 2: Navigate into the project folder
cd kuza-market

# Step 3: Install dependencies
npm install

# Step 4: Start the development server
npm run dev

✏️ Edit Directly on GitHub

  • Navigate to the desired file in this repo

  • Click the ✏️ Edit button (top right)

  • Make your changes and commit them directly to the branch

πŸ’» Use GitHub Codespaces

  • Go to the repo's main page

  • Click the green Code button

  • Select the Codespaces tab

  • Click "New codespace" to launch it

  • Make edits and commit when done

🧰 Tech Stack

πŸ”§ Technology and its βš™οΈ Description

  • ⚑ Vite Lightning-fast dev environment
  • πŸ“˜ TypeScript Type-safe JavaScript
  • React Frontend UI framework
  • πŸ’¨ Tailwind CSS Utility-first CSS styling
  • 🧱 shadcn/ui Beautiful & accessible UI components

πŸ“Έ Screenshots

Add screenshots here to showcase your app!

πŸ“² Contact System

🚫 No in-app payment/transaction functionality yet.

βœ… Users connect directly through:

πŸ“ž WhatsApp

πŸ“§ Email Us

This keeps things lean, personal, and simple for now.

🌱 Upcoming Features

πŸ’³ M-Pesa Integration

πŸ›οΈ Add to Cart & Checkout

πŸ—ΊοΈ Map-based Farm Locator

πŸ“Š Admin Analytics Dashboard

❀️ Wishlist & Save for Later

🀝 Contributing

We πŸ’š contributions!

# Fork this repo
# Create a feature branch
git checkout -b feature/your-feature-name

# Commit your changes
git commit -m "✨ Added your feature"

# Push and create a Pull Request

πŸ“¬ Contact & Support

🌐 Website: Kuza Market

πŸ“ž WhatsApp: +254 790767347

πŸ“§ Email: support@kuzamarket.com

⭐ Show Some Love

If you like this project, give it a ⭐ on GitHub. Every star helps us grow! πŸ’«

About

Welcome to Kuza Market – a modern digital platform connecting Sellers and buyers across College! πŸ‡°πŸ‡ͺ Whether you're selling second hand goods or buying them Kuza Market simplifies everything. βœ¨πŸ“²

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages