Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trojan-254/zetucart
Kenya's premier ecommerce platform. We offer a seamless online shopping experience with top-notch products, exclusive deals, and fast delivery.
https://github.com/trojan-254/zetucart
ejs expressjs mongodb nodejs tailwindcss
Last synced: 1 day ago
JSON representation
Kenya's premier ecommerce platform. We offer a seamless online shopping experience with top-notch products, exclusive deals, and fast delivery.
- Host: GitHub
- URL: https://github.com/trojan-254/zetucart
- Owner: Trojan-254
- Created: 2024-12-15T10:57:21.000Z (25 days ago)
- Default Branch: main
- Last Pushed: 2025-01-03T17:19:03.000Z (6 days ago)
- Last Synced: 2025-01-03T17:35:29.145Z (6 days ago)
- Topics: ejs, expressjs, mongodb, nodejs, tailwindcss
- Language: EJS
- Homepage:
- Size: 6.97 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ZetuCart - Your Premier Shopping Destination
Welcome to ZetuCart, Kenya's premier ecommerce platform. We offer a seamless online shopping experience with top-notch products, exclusive deals, and fast delivery.
## 🌟 Features
- **User-Friendly Interface**: Intuitive navigation for a seamless shopping experience
- **Popular Categories**: Electronics, Fashion, Home & Living, Beauty, and more
- **Hot Deals**: Exclusive discounts, flash sales, and bundle offers
- **Secure Payments**: Multiple payment options, including M-Pesa integration
- **Fast Delivery**: Next-day delivery in major cities across Kenya
- **Easy Returns**: Hassle-free returns within 7 days
- **Partner Brands**: Trusted collaborations with Mpesa, KCB Bank, Airtel Money, and more
## 📂 Project Structure
```
ZetuCart/
├── index.js # Entry point for the server
├── package.json # Project dependencies and scripts
├── tailwind.config.js # Tailwind CSS configuration
├── views/ # EJS templates for frontend rendering
├── public/ # Static files (CSS, JS, Images)
├── routes/ # Backend routes
├── models/ # Database schemas
├── middleware/ # Custom middleware functions
├── uploads/ # Directory for user-uploaded content
├── utils/ # Utility functions
└── README.md # Project documentation
```
## 🛠️ Tech Stack
- **Frontend**: EJS, Tailwind CSS, FontAwesome
- **Backend**: Node.js, Express.js
- **Database**: MongoDB
- **Payment Integration**: M-Pesa API
- **Hosting**: TBD
## 🚀 Getting Started
### Prerequisites
- Node.js installed
- MongoDB set up locally or on the cloud
### Installation
1. Clone the repository:
```bash
git clone https://github.com/Trojan-254/ZetuCart.git
cd ZetuCart
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables:
Create a `.env` file in the root directory:
```env
PORT=3000
MONGODB_URI=
MPESA_CONSUMER_KEY=
MPESA_CONSUMER_SECRET=
```
4. Start the development server:
```bash
npx nodemon index.js
```
5. Visit the app:
```
http://localhost:5000
```
## 📄 Key Pages
- **Homepage**: A dynamic interface featuring categories, deals, and testimonials
- **Categories**: Explore popular product groups
- **Deals**: Access hot sales and bundle offers
- **User Profiles**: Secure account management for personalized experiences
## 🤝 Trusted Partners
ZetuCart collaborates with leading Kenyan brands:
- Mpesa
- KCB Bank
- Airtel Money
- Kenya Airways
- And more!
## 🧪 Testing
Run unit tests:
```bash
npm test
```
## 🙌 Community and Contributions
We welcome contributions! Here's how:
1. Fork the repository
2. Create a new branch:
```bash
git checkout -b feature/new-feature
```
3. Commit your changes:
```bash
git commit -m "Add a new feature"
```
4. Push to your branch:
```bash
git push origin feature/new-feature
```
5. Create a Pull Request
## 📧 Contact
For inquiries or support:
- **Email**: [email protected]
- **Twitter**: @zetucart
## ⚖️ License
This project is licensed under the MIT License.