🐺 WRIKICAFE+ — Smart Campus Café Ordering Platform

[] []

A smarter, personalized, and social campus food-ordering system for NC State University. || Funfact: WrikiCafe+ is derived from the Sanskrit word vṛkī (वृकी) meaning she-wolf ||

📌 Overview

WrikiCafe+ provides:

• A simple, intuitive ordering interface for students
• A full admin panel for menu, ingredients, and order flow
• Real-time order notifications
• Social group ordering
• Build-your-own custom item flow
• Order history and insights (extended features)

Originally built for NCSU, the system is adaptable for any university café environment.

---

✨ Features

User Features

• Browse/search menu items
• Personalized build-your-own café items
• Add to cart & checkout
• Real-time order-ready alerts
• Social Group Ordering (create, join, split, finalize)
• Order history & reorder option

Admin Features

• Manage menu items
• Manage ingredients
• Track active orders
• Trigger pickup notifications
• View café performance (extended)

---

🛠️ Tech Stack

Frontend

• React
• Vite
• React Router
• React Testing Library
• TailwindCSS
• Axios

Backend

• Node.js
• Express
• MongoDB (Mongoose)
• Cloudinary
• JWT Authentication
• Nodemailer
• Jest + Supertest

---

📽️ Demo Video (4 min)

🎥 Watch the Demo

---

📦 Installation

1. Clone Repository

git clone https://github.com/rishitharamesh/wolfcafeplus.git
cd wolfcafeplus

2. Install Backend Dependencies

npm install

3. Install Frontend Dependencies

cd frontend
npm install

---

🚀 Running the Application

Start Backend (default port 5000)

npm run dev

Start Frontend (default port 3000)

npm run dev

---

📁 Project Structure

backend/
  api/
    controllers/
    middleware/
    models/
    routes/
    utils/
  server.js

frontend/
  src/
    api/
    components/
    context/
    pages/
    utils/

---

🔑 Environment Variables

Create .env inside backend/:

MONGO_URI=<your_mongo_uri>
JWT_SECRET=<your_jwt_secret>

CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=

EMAIL_USER=
EMAIL_PASS=

Default backend runs on port 5000, frontend on 3000.
Requires MongoDB URI in .env.

---

🧪 Testing

Backend Tests

npm test

Frontend Tests

cd frontend
npm test

Coverage includes:

• Authentication
• Protected Routes
• Group Ordering
• Build-Your-Own flow
• Controllers & API responses

---

👥 Team 19

Name	GitHub
Digvijay Sonvane	@DigvijaySonvane
Suyesh Jadhav	@SuyeshJadhav
Vanaja Agarwal	@VanajaAgarwal

📜 Policies & Standards

File	Description
.gitignore	Lists files excluded from version control
LICENSE.md	Usage rights and open-source license
CODE-OF-CONDUCT.md	Expected behavior in collaboration
CONTRIBUTING.md	Guidelines for coding, PRs, testing, and branching
INSTALL.md	Detailed installation and environment setup instructions

🧰 Tech Stack

Frontend: React 19 · Vite · Axios · TailwindCSS Backend: Node · Express · MongoDB (Mongoose) · socketio Auth: JWT · bcrypt
Storage: Cloudinary · MongoDB Atlas
Testing: Jest · Supertest · React Testing Library

💡 Why This Stack?

wrikicafe is built with the MERN stack (MongoDB, Express.js, React, Node.js) to demonstrate a complete, modern web application architecture:

• MongoDB: Flexible data modeling for users, menu items, and orders.
• Express + Node.js: Efficient REST API with authentication and real-time Socket.IO communication.
• React: Interactive, responsive frontend built with Vite and Tailwind CSS.

🧾 License

This project is released under the terms described in LICENSE.md.

© 2025 WrikiCafe+ Team 19 · North Carolina State University