Soko Langu - Market Trade and Marketing Hub System

Soko Langu is a web-based application system designed to facilitate market trade and marketing activities for farmers, traders, and consumers. This platform allows users to interact, place orders, and manage their products effectively. It offers an intuitive interface for farmers to list their products, consumers to browse the products, and allows communication between the two parties.

VIEW LIVE - SokoLangu

Features

• User Authentication: Allows users to register, log in, and manage their account.
• Product Listings: Farmers can add, update, and manage their products.
• Order Management: Consumers can place orders for products listed by farmers.
• Messaging System: Enables communication between farmers and consumers.
• Search Functionality: Users can search for products based on various categories.
• Responsive Design: The web application is fully responsive and works seamlessly on both desktop and mobile devices.

---

Tech Stack

• Frontend: React.js
• Backend: PHP with MySQL (For database and server-side logic)
• Authentication: LocalStorage for storing user session data
• Package Manager: Yarn
• Libraries: React Router, Axios, React Hooks, etc.

---

Screenshots

HomePage

GetStarted Page

Farmer's Signup

Consumer's Signup

Login Page

ProductView Page

For more, view the folder: sokolangu screenshots.

Installation

Follow the steps below to set up the project locally:

Prerequisites

Make sure you have the following installed:

• Node.js
• Yarn

Steps to Set Up

1. Clone the repository:

   git clone https://github.com/jumanjigobez/sokolangu.git

2. Navigate into the project directory:

   cd sokolangu

3. Install dependencies using Yarn:

   yarn install

4. Run the development server:

   yarn start

5. Visit http://localhost:3000 in your browser to see the application.

---

Usage

Once the project is up and running, users can:

1. Register or log in to access the platform.
2. Browse products listed by farmers and make purchases.
3. Place orders directly through the platform.
4. Send messages between consumers and farmers.
5. Manage products if logged in as a farmer.

---

API Endpoints

The backend handles various API endpoints for managing users, products, and orders. Below is a summary of the available endpoints:

• /api/register - Register a new user (POST)
• /api/login - Log in an existing user (POST)
• /api/products/getProducts - Get list of products (GET)
• /api/products/addProduct - Add a new product (POST)
• /api/orders/placeOrder - Place a new order (POST)
• /api/messages/sendMessage - Send a message (POST)

---

Contributing

Contributions are welcome! If you find a bug or would like to improve the project, feel free to create an issue or submit a pull request. Please ensure that you follow these guidelines:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push your branch to your forked repository
5. Open a pull request with a clear description of your changes

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Acknowledgements

• Special thanks to The one and only Allah for enabling me finish up in timely deadline of 5 days imagine.
• React, Yarn, and PHP for providing the foundation for this project.
• And Definitely thanks to You for checking out and trying out SokoLangu

Author

• Name - Juma Chaje
• Portfolio - View Portfolio
• Instagram - @jumanjicasilas
• Youtube - @jumanji_dev

Support & Appreciation

For any issue or anything as an appreciation feel free to reach via my email [email protected]