MutisoMuli / royal_gems_v3

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

RoyalGems

RoyalGems is an eCommerce platform designed specifically for the Kenyan market, offering a seamless online shopping experience for gemstones and jewelry. Developed by a talented team of developers, Anthony Muli (Backend Developer) and Mutiso Muli (Frontend Developer), RoyalGems aims to provide a user-friendly and visually appealing interface for both customers and administrators.

Features

User Experience

  • Intuitive User Interface: The website boasts a clean and modern design, ensuring an enjoyable browsing experience for customers.
  • Easy Navigation: Users can effortlessly navigate through different product categories, search for specific items, and view detailed product information.
  • Secure Checkout: RoyalGems prioritizes customer security by implementing a secure checkout process, ensuring safe transactions.

Admin Panel

  • Inventory Management: The admin panel allows administrators to efficiently manage product inventory, including adding, updating, and removing products from the catalog.
  • Order Management: Administrators can view and process customer orders, update order statuses, and manage shipping details.
  • Shipping Management: The platform integrates with various shipping providers, enabling administrators to manage domestic and international shipping options for orders within and outside Nairobi.

Additional Features

  • User Authentication: Customers can create accounts, securely store their information, and track their order history.
  • Product Reviews: Customers can leave reviews and ratings for products they've purchased, aiding others in making informed decisions.
  • Wishlist and Cart Functionality: Users can add desired items to their wishlist or shopping cart for future reference or purchase.
  • Promotional Tools: Administrators can create and manage promotional campaigns, such as discounts, coupons, and special offers.

Technologies Used

  • Frontend: React.js, HTML5, CSS3, JavaScript
  • Backend: Node.js, Express.js
  • Database: MongoDB
  • Payment Gateway Integration: We plan to intergrate M-Pesa and PayPal
  • Shipping Integration: We plan to intergrate googlemaps to utilise local bodaboda riders

Getting Started

To run the RoyalGems platform locally, follow these steps:

  1. Clone the repository: git clone https://github.com/MutisoMuli/royal_gems_v3.git
  2. Install dependencies: npm install
  3. Configure environment variables (e.g., database connection, API keys)
  4. Start the development server: npm start

Contributing

We welcome contributions from the community! If you'd like to contribute to RoyalGems, please follow these steps:

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes and commit them: git commit -m 'Add your commit message'
  4. Push to the branch: git push origin feature/your-feature-name
  5. Submit a pull request

License

RoyalGems is released under the MIT License.

Contact

For any inquiries or support, please contact:

About


Languages

Language:TypeScript 97.6%Language:JavaScript 2.0%Language:CSS 0.5%