Mess Ledger Logo
Mess Ledger
User Guide

How to Use
Mess Ledger

A complete visual walkthrough of every feature — from calculating your first mess to managing your account settings.

7 Sections Covered
For Mess Managers
Secure & Private

1. The Landing Page

The landing page is your gateway. From here you can jump straight into calculating a new mess, or explore how Mess Ledger works.

localhost:3000/
Mess Ledger Home / Landing Page

Step-by-Step

1

Calculate Your Next Mess

Click this button to go directly to the Data Entry Hub — the fastest way to get started.

2

View Workflow

Scrolls down the landing page to show you a step-by-step overview of how Mess Ledger works.

3

Navigation Bar

The top nav gives you access to Home, Calculate, Activities, and Help at any time.

4

Avatar / Login

The top-right avatar shows your initials if logged in. Click it to go to the Dashboard.

💡 Pro Tips

  • You do not need an account to run a quick calculation.
  • The live transaction card is an animated preview of a real mess split.

2. Signing In

Sign in to your account to save your calculations, view your history, and access your personal dashboard.

localhost:3000/auth/login
Mess Ledger Login Page

Step-by-Step

1

Email Field

Enter the email address you registered with.

2

Password Field

Enter your password. Use the eye icon to toggle visibility.

3

Sign In Button

Click to authenticate. You will be redirected to the Dashboard on success.

4

Google Sign-In

Use "Continue with Google" to log in instantly using your Google account — no password needed.

5

Register Link

If you don't have an account yet, click "Create an account" at the bottom.

💡 Pro Tips

  • Passwords must be at least 8 characters.
  • If you forgot your password, contact support — a reset flow is coming soon.

3. Creating an Account

Registration is quick. You need a name, email, and password. An OTP will be sent to your email to verify your account.

localhost:3000/auth/register
Mess Ledger Register Page

Step-by-Step

1

Full Name

Enter your real name (3–50 characters). This appears on your Dashboard and reports.

2

Email Address

A valid email address — this is your login ID.

3

Password

Choose a secure password of at least 8 characters.

4

Create Account

Clicking this sends an OTP to your email for verification.

5

OTP Verification

Enter the 6-digit code from your email in the verification modal that appears.

💡 Pro Tips

  • Check your spam/junk folder if the OTP email doesn't arrive.
  • You can also sign up instantly with Google without needing an OTP.

4. Your Dashboard

The Dashboard is your personal audit control center. It shows your total spending, peer group size, security status, and your full calculation history.

localhost:3000/dashboard
Mess Ledger Dashboard

Step-by-Step

1

Profile Header

Shows your name, verified status, and account tier.

2

Local Page Bazar

Your cumulative total BDT spent across all saved mess sessions.

3

Peer Group

The total number of unique members across all your mess calculations.

4

Security Standing

Confirms your account is active and in good standing.

5

Calculation History

Table of all your saved sessions — timestamp, title, total, and a Details button.

6

Details Button

Click Details on any row to see the full breakdown of that specific mess calculation.

7

Export

Export your calculation history as a file for record-keeping.

8

Modify Identity

Navigate to Settings to change your name or password.

💡 Pro Tips

  • The dashboard paginates 5 records at a time — scroll down to see the pagination controls.
  • Your data is saved automatically every time you submit a calculation.

5. Running a Calculation

The Data Entry Hub is where the magic happens. Enter your members, market costs, and utilities — and Mess Ledger calculates exactly what each person owes.

localhost:3000/calculate
Mess Ledger Calculate / Data Entry Hub

Step-by-Step

1

Members Table

Add each member's name and their individual deposit (if any). Use "+ Add Row" to add more members.

2

Total Members Qty

Enter the total number of members and click ADD for quick bulk member generation.

3

Run Simulation

Click "RUN SIMULATION" to auto-generate a realistic demo dataset for testing.

4

Total Bazar

Enter the total market cost for the month in BDT (৳).

5

Month

Select the month this calculation covers — used for the session title.

6

Title

Give this session a name (e.g., "June Mess"). Auto-filled if left blank.

7

Standard Utilities

Enter shared bills: WiFi, electricity, other costs. These are split equally.

8

Submit / Calculate

Hit the Calculate button at the bottom. Results appear instantly on screen.

9

Save to Dashboard

After calculating, you can save the session to your Dashboard history.

💡 Pro Tips

  • Leave deposits as 0 if nobody paid in advance.
  • The "Mills" column tracks how many meals each member consumed.
  • You can delete rows with the trash icon on each member row.

6. Global Activity Feed

The Activities page shows a live global pulse — all recent calculations submitted by all users on the platform.

localhost:3000/activity
Mess Ledger Global Activity Feed

Step-by-Step

1

Live Transactions

Displays recent mess calculations from all users in near real-time.

2

Session Cards

Each card shows: session title, total bazar, member count, and the month.

3

Browse & Discover

Get a feel for how other households are using Mess Ledger.

💡 Pro Tips

  • This is a read-only view — you cannot interact with other users' sessions.
  • Your own sessions will appear here too after saving from the Calculate page.

7. Settings & Account

The Settings page lets you manage your public identity, update your password, and sign out of your account.

localhost:3000/settings
Mess Ledger Settings / Auditor Configuration

Step-by-Step

1

Public Identity

Update your display name. This appears on your Dashboard and all reports.

2

Email (Read-Only)

Your registered email cannot be changed from here.

3

Update Identity

Click "Update Identity" to save your new name.

4

Current Password

Enter your existing password before setting a new one.

5

New Password & Confirm

Enter and confirm a new password (minimum 8 characters).

6

Update Protocol

Click to apply the new password. You will remain logged in.

7

Sign Out

Securely destroy your session and return to the landing page.

💡 Pro Tips

  • Changing your password does not log you out automatically.
  • Use the Sign Out button to fully clear your session from this device.

Frequently Asked Questions

Quick answers to the most common questions about Mess Ledger.

Ready to Start?

Jump into the calculator and run your first mess in under a minute.