🧃 Juice Receipt App

A modern full-stack receipt generation system designed for small juice businesses, enabling effortless creation, management, and printing of professional receipts.

---

✨ Overview

Juice Receipt App is designed to streamline the billing process for small juice shops. The application allows business owners to:

• Manage juice flavours efficiently
• Generate receipts quickly and professionally
• Format receipts for thermal printing (80mm)
• Export receipts as PDF
• Track and view receipt history
• Support multiple currencies (LKR & USD)

Built with a modern tech stack, it emphasizes performance, scalability, and usability.

---

🚀 Features

• 🧃 Juice Flavour Management – Add, edit, delete flavours
• 📝 Professional Receipt Creation
• 🖨️ Thermal Printer Support (80mm format)
• 📄 Download Receipts as PDF
• 📋 View Receipt History
• 💱 Multi-Currency Support (LKR & USD)
• 📱 Mobile Responsive Design
• 🔐 User Authentication & Authorization
• ⚡ Fast and Lightweight UI

---

🛠️ Tech Stack

Frontend

• React
• Tailwind CSS
• Zustand

Backend

• Node.js
• Express.js

Database

• MongoDB

Utilities

• jsPDF (PDF Generation)
• JWT Authentication

---

📦 Getting Started

✅ Prerequisites

Before running the application, ensure the following are installed:

• Node.js v18+
• MongoDB (Local or Atlas)

---

📸 Screenshots

Dashboard Preview

Flavours Section

Receipt Creation Section

Receipt History Section

Contact Settings Section

---

📥 Installation

1️⃣ Clone the repository

git clone https://github.com/YOUR_USERNAME/juice-receipt-app.git
cd juice-receipt-app

2️⃣ Install dependencies

Backend:

cd backend
npm install

Frontend:

cd ../frontend
npm install

3️⃣ Set up Environment Variables

Backend (backend/.env):

MONGODB_URI=mongodb://localhost:27017/juice-receipt-app
JWT_SECRET=your-secret-key
PORT=5000

<p><strong>Frontend (<code>frontend/.env</code>):</strong></p>
<pre><code>REACT_APP_API_URL=http://localhost:5000/api</code></pre>

4️⃣ Run the Application

Terminal 1 – Backend:

cd backend
npm start

<p><strong>Terminal 2 – Frontend:</strong></p>
<pre><code>cd frontend

npm start

<p>Open in your browser: <a href="http://localhost:3000">http://localhost:3000</a></p>

🌍 Deployment

Deployment instructions are available in: 📄 DEPLOY_TO_VERCEL.md

Supports multiple platforms:

• Vercel
• Render
• Railway
• MongoDB Atlas

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

Sadeesha Vishmitha Jayaweera