Skip to content

Kashan-2912/kissan360

Repository files navigation

Kissan360 Logo

🌾 Kissan360 (FMS Marketplace)

A Revolutionary Farm Management System & Marketplace
Connecting farmers globally and transforming agricultural commerce.

React TypeScript Vite Redux Toolkit Tailwind CSS


📖 Overview

Kissan360 (Farm Management System Marketplace) is a cutting-edge agricultural platform designed to bridge the gap between local farmers and global buyers. It offers a seamless, secure, and intuitive ecosystem for farmers to sell their fresh produce and for buyers to purchase premium agricultural items at the best prices.

The platform is built with a modern tech stack ensuring high performance, a stunning glassmorphism-inspired UI, and a highly responsive user experience.


✨ Key Features

  • 🛒 Dedicated Marketplaces: Separate, tailored flows for Purchasing Items and Selling Products.
  • 🌱 Fresh Produce Direct: Connect directly with farmers, cutting out middlemen to ensure freshness and the best pricing.
  • 🛡️ Quality Assurance: A secure environment for verified sellers and products, fostering a trusted community.
  • 📊 Real-time Community: A platform connecting 10,000+ active farmers with a global network of buyers.
  • 🎨 Beautiful UI/UX: Stunning visually immersive interface featuring dynamic gradient backgrounds, scroll animations, glowing elements, and Tailwind CSS + Mantine integration.
  • 📱 Fully Responsive: Optimized for both mobile devices and large desktop displays.

🛠️ Technology Stack

Core Technologies

  • React 19 - State-of-the-art UI library.
  • TypeScript - For type-safe code and scalable development.
  • Vite - Next-generation, lightning-fast frontend tooling.

State Management & Routing

Styling & UI Libraries

  • Tailwind CSS v4 - Utility-first CSS framework for rapid and scalable styling.
  • Mantine UI - Rich set of accessible, highly functional React components (@mantine/core, @mantine/carousel, @mantine/hooks).
  • Lucide React & Tabler Icons - Beautiful, scalable, and consistent icon sets.
  • Custom Fonts: Montserrat (Primary), Niramit, and Poppins.

Forms & Validation

  • Formik - Robust form state management.
  • Yup - Schema builder for runtime value parsing and validation.

📂 Folder Structure

The project follows a modular and scalable directory structure:

kissan360/
├── public/                 # Static assets (Favicons, etc.)
├── src/                    # Main application source code
│   ├── assets/             # Images, SVGs, and global static files
│   ├── components/         # Reusable, modular UI components
│   ├── layouts/            # Page layout wrappers (e.g., Navbar, Footer, Sidebar)
│   ├── pages/              # Top-level route components
│   │   ├── HomePage.tsx    # FMS Landing Page
│   │   ├── purchase/       # Purchase marketplace pages
│   │   └── sell/           # Selling dashboard and product management pages
│   ├── routes/             # Route configurations
│   │   ├── PurchaseRoutes.tsx
│   │   └── SellRoutes.tsx
│   ├── store/              # Redux setup, slices, and asynchronous thunks
│   ├── types/              # TypeScript interfaces and global type definitions
│   ├── util/               # Helper functions and utilities
│   ├── validation/         # Yup schemas for Formik validation
│   ├── App.tsx             # Root React component connecting routes
│   └── main.tsx            # React application entry point
├── index.html              # Main HTML template
├── package.json            # Project dependencies and operational scripts
├── tailwind.config.js      # Tailwind customization (if applicable)
├── tsconfig.json           # TypeScript configuration files
└── vite.config.ts          # Vite bundler configuration

🚀 Getting Started

Follow these steps to set up the project locally.

1. Prerequisites

Ensure you have the following installed on your machine:

  • Node.js (v18 or higher recommended)
  • npm (comes with Node.js) or yarn

2. Installation

Clone the repository and install the dependencies:

# Clone the project (replace with your repo link)
git clone https://github.com/your-username/kissan360.git

# Navigate into the directory
cd kissan360

# Install NPM dependencies
npm install

3. Running the Development Server

To start the Vite development server with Hot Module Replacement (HMR):

npm run dev

Navigate to http://localhost:5173 in your browser to view the application.

4. Building for Production

To create an optimized production build:

npm run build

This will compile TypeScript and bundle the app into the dist/ directory.

5. Previewing the Production Build

You can preview the generated production build locally:

npm run preview

🧹 Linting & Code Quality

Kissan360 enforces strict code quality through ESLint.

To run the linter and find potential issues:

npm run lint

The project utilizes typescript-eslint for deep type-aware linting alongside specific rules from eslint-plugin-react-refresh to ensure React best practices are maintained.


Developed to empower the agricultural community worldwide. 🌍

About

Figma to React + Mantinue UI + TailwindCSS + Formik + Yup + Redux

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages