https://github.com/jumanjigobez/sokolangu
Soko Langu is a web-based application system designed to facilitate market trade and marketing activities for farmers, traders, and consumers. Check it out......
https://github.com/jumanjigobez/sokolangu
agriculture farmers-markets interactive kenya marketplace mysql php reactjs regions responsive-design secured solution stars-5000 system top-star
Last synced: 6 months ago
JSON representation
Soko Langu is a web-based application system designed to facilitate market trade and marketing activities for farmers, traders, and consumers. Check it out......
- Host: GitHub
- URL: https://github.com/jumanjigobez/sokolangu
- Owner: Jumanjigobez
- Created: 2025-02-11T07:15:34.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-02-20T08:14:55.000Z (8 months ago)
- Last Synced: 2025-02-20T09:27:31.345Z (8 months ago)
- Topics: agriculture, farmers-markets, interactive, kenya, marketplace, mysql, php, reactjs, regions, responsive-design, secured, solution, stars-5000, system, top-star
- Language: JavaScript
- Homepage: https://sokolangu.infinityfreeapp.com
- Size: 30.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](https://sokolangu.infinityfreeapp.com)
---
## 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](https://nodejs.org/)
- [Yarn](https://classic.yarnpkg.com/en/docs/install/)
### Steps to Set Up
1. Clone the repository:
```bash
git clone https://github.com/jumanjigobez/sokolangu.git
```
2. Navigate into the project directory:
```bash
cd sokolangu
```
3. Install dependencies using Yarn:
```bash
yarn install
```
4. Run the development server:
```bash
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](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](https://jumanjigobez.github.io/personal_portfolio)
- Instagram - [@jumanjicasilas](https://instagram.com/@jumanjicasilas)
- Youtube - [@jumanji_dev](https://youtube.com/@jumanji_dev)
## Support & Appreciation
For any issue or anything as an appreciation feel free to reach via my email [jumagobe3@gmail.com](mailto:jumagobe3@gmail.com)