Skip to content

Dadaisuk1/ani-hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌾 ani-hub

Isang digital na palengke para sa mga magsasaka ng Pilipinas. A digital farm-to-market platform connecting Filipino farmers directly to consumers β€” no middlemen, just fresh and fair.

Status License Stack


πŸ“Œ About the Project

Ani-Hub is a solo portfolio project β€” a full-stack digital farm-to-market platform inspired by the real agricultural supply chain challenges faced by Filipino farmers in Cebu, Philippines.

The platform eliminates intermediaries by giving farmers a digital space to list their produce, and consumers an easy way to browse and order fresh vegetables directly from the source. Inspired by the research-backed problem space of platforms like Tabo-Ani, ani-hub is built independently as a demonstration of full-stack web development skills.

The name Ani (meaning harvest in Filipino) reflects the core mission: to bring the fruits of farmers' labor directly to the hands of the people.


πŸš€ Tech Stack

Layer Technology
Web Frontend Next.js 14, Tailwind CSS, shadcn/ui
Backend Node.js, Express
ORM Prisma
Database PostgreSQL
Hosting & Storage Supabase
Auth JWT
Maps Google Maps API
Payments GCash / Bank Transfer (planned)

πŸ‘₯ User Roles

Role Description
Farmer Lists produce, manages inventory, receives and confirms orders
Consumer Browses listings, places orders, leaves reviews

✨ Core Features (v1)

  • User registration and authentication (Farmer / Consumer)
  • Product listings with photo upload and stock management
  • Order placement and status tracking
  • Reviews and ratings system
  • Farm location via Google Maps embed
  • Real-time notifications (planned)
  • Secure payment options via GCash (planned)

πŸ“ Project Structure

ani-hub/
β”œβ”€β”€ client/         # Next.js web frontend
β”œβ”€β”€ server/         # Node.js + Express REST API
β”œβ”€β”€ docs/           # Project documentation and case study
└── README.md

βš™οΈ Getting Started

Prerequisites: Node.js v18+, npm or yarn, PostgreSQL

1. Clone the repository

git clone https://github.com/<your-username>/ani-hub.git
cd ani-hub

2. Set up the server

cd server
npm install
cp .env.example .env
# Fill in your environment variables in .env

3. Set up the client

cd ../client
npm install
cp .env.example .env.local
# Fill in your environment variables in .env.local

4. Run database migrations

cd ../server
npx prisma migrate dev

5. Start the development servers

# In /server
npm run dev

# In /client (separate terminal)
npm run dev

The web app will be available at http://localhost:3000 and the API at http://localhost:5000.


🌿 Environment Variables

Create a .env file in /server with the following:

DATABASE_URL=postgresql://user:password@localhost:5432/anihub
JWT_SECRET=your_jwt_secret
PORT=5000
GOOGLE_MAPS_API_KEY=your_google_maps_key

Create a .env.local file in /client with:

NEXT_PUBLIC_API_URL=http://localhost:5000
NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=your_google_maps_key

πŸ—„οΈ Database Schema

Core tables: USERS, PRODUCTS, ORDERS, ORDER_ITEMS, REVIEWS

See /docs/schema.md for the full ERD and field definitions.


πŸ“‹ Commit Convention

This project follows a short-prefix commit convention:

Prefix Purpose
f: New feature
fix: Bug fix
ui: UI / styling changes
api: API / backend changes
db: Database / migrations
auth: Authentication
docs: Documentation
refactor: Code cleanup
chore: Maintenance / dependencies
web: Web-specific changes

Format: <prefix> <short description in lowercase, present tense>

Example: f: add farmer product listing page


πŸ—ΊοΈ Roadmap

  • Project planning and ERD design
  • Wireframes (farmer-side)
  • Prisma schema setup
  • Auth β€” register and login
  • Product CRUD API
  • Farmer dashboard
  • Consumer marketplace
  • Order management
  • Reviews and ratings
  • Google Maps integration
  • Deployment (Vercel + Railway)

πŸ“œ License

This project is licensed under the Ani-Hub Custom Academic & Non-Commercial License v1.0. See LICENSE for full details.

This software is developed for portfolio purposes. Commercial use is strictly prohibited without written consent.


🌾 Para sa mga magsasaka ng Pilipinas. β€” For the farmers of the Philippines. 🌾

About

🌱 Skip the middlemen. Connect farmers to consumers directly β€” the Filipino way.

Topics

Resources

License

Stars

Watchers

Forks

Contributors