🌿 FarmFresh — Farm to Table, Delivered Fresh

A full-stack e-commerce platform connecting local farmers directly to urban families. Built with Node.js, Express, MongoDB & EJS.

---

📸 Preview

Page	Description
🏠 Homepage	Hero section, featured products, testimonials
🛒 Explore	Filter by category, tags, search & sort
📦 Cart	Live drawer cart + dedicated cart page
✅ Checkout	COD / Online payment, order saved to DB
👤 Profile	User details + full order history
🛡️ Admin	Dashboard, product CRUD, order management

---

✨ Features

🧑‍💻 Customer Side

• Dynamic Homepage — hero with live product cards, featured picks, new arrivals & testimonials
• Smart Explore Page — search, filter by category, filter by tag (Organic, Best Seller, Seasonal, New), sort by price / name
• Live Cart — localStorage-powered cart drawer available on every page, with quantity controls
• Full Cart Page — editable cart with order summary and delivery threshold tracker (free above ₹499)
• Checkout — auto-fills details for logged-in users, supports COD & Online payment, saves order to MongoDB
• Order Confirmation — dedicated success page with full order breakdown
• Authentication — register, login, logout with bcrypt-hashed passwords & secure sessions
• User Profile — update name, phone, address; view complete order history with status badges

🛡️ Admin Panel (/admin)

• Dashboard — real-time stats: total products, orders, users, and cumulative revenue
• Product Management — full CRUD (add, edit, delete) with image upload via Multer
• Order Management — view all orders, update statuses (Pending → Confirmed → Shipped → Delivered → Cancelled)
• Protected routes — requireAdmin middleware blocks unauthorized access

---

🚀 Getting Started

Prerequisites

• Node.js v18 or higher
• MongoDB running locally or a free MongoDB Atlas cluster

1. Clone the repository

git clone https://github.com/yourusername/ProjectFarmFresh.git
cd ProjectFarmFresh

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env

Open .env and fill in your values:

PORT=3000
MONGODB_URI=mongodb://localhost:27017/farmfresh
SESSION_SECRET=pick_a_long_random_string_here
NODE_ENV=development

4. Seed the database

npm run seed

This loads 18 products across 6 categories and creates an admin account:

Field	Value
Email	admin@farmfresh.in
Password	admin1234

⚠️ Change the admin password after your first login in production.

5. Start the server

npm run dev     # development — auto-restarts on changes (nodemon)
npm start       # production

Open http://localhost:3000 🎉

---

📁 Project Structure

ProjectFarmFresh/
│
├── app.js                        # Express server entry point
├── seed.js                       # Database seeder (products + admin)
├── .env.example                  # Environment variable template
│
├── data/
│   └── products.json             # 18 seed products
│
├── middleware/
│   └── auth.js                   # requireLogin & requireAdmin guards
│
├── models/
│   ├── User.js                   # User schema (bcrypt, sessions)
│   ├── Product.js                # Product schema (category, tags, image, stock)
│   └── Order.js                  # Order schema (items, status, guest support)
│
├── routes/
│   ├── productRoutes.js          # /, /explore, /cart, /checkout, /api/products
│   ├── authRoutes.js             # /login, /register, /logout, /profile
│   ├── contactRoutes.js          # /contact
│   └── adminRoutes.js            # /admin/**
│
├── views/
│   ├── partials/
│   │   ├── header.ejs            # Sticky nav, cart drawer, flash messages
│   │   └── footer.ejs            # Footer, cart drawer HTML, toast
│   │
│   ├── admin/
│   │   ├── _sidebar.ejs
│   │   ├── dashboard.ejs
│   │   ├── manageProducts.ejs
│   │   ├── addProduct.ejs
│   │   ├── editProduct.ejs
│   │   └── orders.ejs
│   │
│   ├── index.ejs                 # Homepage
│   ├── explore.ejs               # Browse + filter products
│   ├── cart.ejs                  # Full cart page
│   ├── checkout.ejs              # Checkout form
│   ├── order-success.ejs         # Order confirmation
│   ├── login.ejs                 # Login + Register (tabbed)
│   ├── profile.ejs               # User profile + order history
│   ├── about.ejs
│   ├── contact.ejs
│   ├── 404.ejs
│   └── 403.ejs
│
└── public/
    ├── css/
    │   ├── style.css             # Global styles
    │   └── admin.css             # Admin panel styles
    ├── js/
    │   └── main.js               # Cart logic (localStorage), toast, drawer
    └── images/                   # Product images uploaded via admin

---

🔧 Environment Variables

Variable	Description	Default
PORT	Port the server runs on	3000
MONGODB_URI	MongoDB connection string	mongodb://localhost:27017/farmfresh
SESSION_SECRET	Secret key for session encryption	(change in production!)
NODE_ENV	development or production	development

---

🛠 Tech Stack

Layer	Technology	Purpose
Runtime	Node.js v18+	JavaScript server runtime
Framework	Express.js 4.19	HTTP routing & middleware
Database	MongoDB + Mongoose 8	Data persistence & ODM
Templating	EJS	Server-side HTML rendering
Auth	bcryptjs + express-session	Password hashing & session management
Sessions	connect-mongo	Persistent sessions stored in MongoDB
File Upload	Multer	Product image uploads
Dev Tool	Nodemon	Auto-restart on file changes
Fonts	Google Fonts	Playfair Display + DM Sans

---

🌐 Routes Overview

Method	Route	Access	Description
GET	/	Public	Homepage
GET	/explore	Public	Browse & filter products
GET	/api/products	Public	JSON product API
GET	/cart	Public	Cart page
GET	/checkout	Public	Checkout page
POST	/checkout	Public	Place order → {success, orderId}
GET	/order-success/:id	Public	Order confirmation
GET/POST	/login	Guest	Login
GET/POST	/register	Guest	Register
GET	/logout	—	Destroy session
GET/POST	/profile	🔒 Login	Profile & orders
GET	/admin	🛡️ Admin	Dashboard
GET/POST	/admin/products/add	🛡️ Admin	Add product
GET/POST	/admin/products/edit/:id	🛡️ Admin	Edit product
POST	/admin/products/delete/:id	🛡️ Admin	Delete product
GET	/admin/orders	🛡️ Admin	All orders
POST	/admin/orders/status/:id	🛡️ Admin	Update order status

---

🔄 Version History

Version	Description
v2.0	Full-stack rebuild — Express + MongoDB + Admin Panel + Auth + Orders
v1.0	Original college project — static HTML/CSS/JS with EJS templates

---

🤝 Contributing

Pull requests are welcome. For major changes, open an issue first to discuss what you'd like to change.

1. Fork the repository
2. Create your branch: git checkout -b feature/your-feature-name
3. Commit your changes: git commit -m 'Add: your feature description'
4. Push to branch: git push origin feature/your-feature-name
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License.

---

👨‍💻 Author

| Aryan Bhati |

"From the field to your table — fresh, honest, and fairly priced."

---

⭐ If you found this project useful, give it a star!