Mess Ledger - Frontend

A modern, responsive dashboard for managing mess expenses and ledger, built with Next.js.

🥣 What is this for?

Mess Ledger is a financial management tool designed for residents of shared living arrangements (Messes/Boardings). It eliminates the hassle of manual bookkeeping for food costs, utility bills, and meal counts.

Through this dashboard, users can:

• Monitor Balances: See real-time calculations of money deposited vs. spent.
• Track Meals: View daily meal counts and the current monthly meal rate.
• Manage Expenses: Admins can easily input marketing (Bazar) costs and fixed bills (WiFi, Maid service).
• Financial Transparency: Every member has access to the transparent ledger, ensuring fair distribution of costs.

✨ Features

• Dashboard: Real-time overview of mess activities and balances.
• Authentication: Secure login and registration with Google Auth integration.
• Ledger Management: Easily track and manage daily expenses and meal counts.
• Responsive Design: Fully optimized for desktop and mobile viewing.
• Premium UI: Crafted with a clean, modern aesthetic using Tailwind CSS.

🚀 Tech Stack

• Framework: Next.js 15+ (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• State Management: React Hooks & Context API
• Icons: Lucide React

🛠️ Getting Started

Prerequisites

• Node.js 18+
• npm, yarn, or pnpm

Installation

1. Clone the repository:

   git clone <repository-url>
   cd FRONTEND

2. Install dependencies:

   npm install

3. Environment Configuration: Create a .env.local file in the root directory:

   NEXT_PUBLIC_API_URL=http://localhost:8010
   NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key

4. Start the Development Server:

   npm run dev

   Open http://localhost:3000 in your browser.

📦 Build for Production

To create an optimized production build:

npm run build
npm run start

📂 Project Structure

• src/app/: Next.js App Router pages and layouts.
• src/components/: Reusable React components (UI, layout, forms).
• src/lib/: Utility functions and API clients.
• public/: Static assets (images, fonts).

📜 License

This project is licensed under the MIT License.