Budget Monitoring

⚡ Real-Time Sync via Google Firebase (Free)

Follow these steps once. After setup, this app works on any phone or computer — all data syncs instantly across your whole team.

Step 1 — Create a Firebase Project

Open console.firebase.google.com in a browser → click "Create a project" → name it mapano-budget → skip Google Analytics → click Create.

Step 2 — Enable Realtime Database

In your new project: left menu → Build → Realtime Database → click "Create database" → choose Singapore (asia-southeast1) → select "Start in test mode" → Enable.

⚠️ Step 2b — Fix Database Rules (IMPORTANT)

After creating the database, go to the Rules tab and make sure it looks like this, then click Publish:

{
  "rules": {
    ".read": true,
    ".write": true
  }
}

If this says false instead of true, the app cannot save any data — that is why adding members or releasing funds does not work.

Step 3 — Get your Web App Config

Click the ⚙️ gear (Project Settings) → scroll to "Your apps" → click the </> (Web) icon → name it BudgetApp → Register. Copy the entire firebaseConfig = { ... } block shown.

Step 4 — Paste Config into this HTML file

Open this file BudgetMonitor_Mapano.html in Notepad (right-click → Open with → Notepad). Find the section that says PASTE YOUR FIREBASE CONFIG HERE near the top of the <script> block. Replace the placeholder values with your real values.

Step 5 — Set Your Owner PIN

In the same area, change const OWNER_PIN = "1234" to your preferred secret 4-digit number. Save the file.

Step 6 — Share with your Team

Upload the file to Google Drive, share the link with your staff. They tap the link, open it in any browser — no app to install. Or share via Viber/Messenger as a file attachment.

Until Firebase is configured, the app runs in Demo Mode — everything works but data is stored on your device only (not shared with staff).

📖 Staff User Guide

Budget Monitor — Mapano Residence

🏗️ What is Budget Monitor?

Budget Monitor is the official fund tracking app for the Mapano Residence construction project. As a staff member, you can request funds, track your active releases, record expenses, and communicate with the owner — all in one place.

1 Logging In

① On the welcome screen, tap 🔢 Sign in with PIN.

② Type your first name (or full name) in the Username field.

③ Enter your 4-digit PIN using the number pad.

④ If Face ID / Biometrics is set up, you can tap 🔒 Sign in with Face ID instead for faster access.

💡 If you forget your PIN, ask the owner to reset it for you.

2 Your Profile Card

At the top of your dashboard you'll see your profile card showing your name and role.

✍️ Upload Signature — tap to upload a photo of your signature used on fund documents.

🔒 Change PIN — tap to update your login PIN at any time.

🚪 Log out — tap the orange text at the top-right corner of the card to log out and return to the welcome screen.

Tap your profile photo to upload or change your picture.

3 💰 Releases Tab

This tab shows all active fund releases assigned to you by the owner.

Each release card shows: amount released, purpose/items, release date, and remaining balance.

Tap a release card to view details and record your expenses against it.

To add an expense, tap + Add Expense inside the release detail — enter the amount, description, and attach a receipt photo if required.

💡 Always record expenses promptly so the owner can track fund usage in real time.

4 📩 Requests Tab

How to request funds:

① Tap 📩 New Request or the New Request button at the top.

② Enter the amount you need.

③ Describe what it is for (reason/purpose).

④ Select an expense code if applicable.

⑤ Tap Submit Request — the owner will be notified immediately.

Request statuses:

⏳ Pending — waiting for owner review.

✓ Approved — owner approved; funds will be released.

✗ Rejected — request was declined.

↩ Returned — owner sent it back with notes for revision.

Editing & Re-submitting:

If your request is Returned, read the owner's note shown on the card.

Tap ✏️ Edit to update the request, then tap 📤 Re-submit to send it again.

You can also 🗑 Delete a pending or returned request if it is no longer needed.

5 ✅ Liquidated Tab

Shows all fund releases that have been fully liquidated — meaning all expenses have been recorded and verified by the owner.

A liquidated release is closed and no further expenses can be added.

You can still view the full expense breakdown of each liquidated release for your records.

✅ A high liquidated count means you are keeping your funds well-accounted for — great work!

6 📋 History Tab

A complete timeline of all your releases and requests — approved, rejected, and pending.

Use this tab to review past transactions and track your fund history over time.

Each entry shows the amount, purpose, date, and current status.

7 💬 Chat Tab

Send and receive real-time messages with the owner and your team members.

Tap the Chat tab — unread messages are shown with a red badge count.

Type your message in the text box at the bottom and tap Send.

You can also join group chats for specific topics or teams.

💡 Use chat to follow up on pending requests or coordinate with the owner on fund releases.

8 🔔 Notifications

The Notifications tab shows all system alerts relevant to you.

You will be notified when:

• Your fund request is approved or rejected by the owner.

• A fund release is assigned to you.

• Your request is returned for revision with owner notes.

• Important project announcements from the owner.

Enable push notifications when prompted so you never miss an update even when the app is in the background.

9 🚪 Logging Out

Tap the 🚪 Log out link at the top-right of your profile card to securely log out.

You will be returned to the main welcome screen.

💡 Always log out when using a shared device to keep your account secure.

Budget Monitor · Meraki-Tech Builders Inc.

For help, contact your project owner.

Owner Access

Budget Monitoring

Fund Requests

Liquidation Requests

Awaiting Fund Release

Active Releases

All Releases

Liquidated Releases

Team Members

Expense Codes

Expense Reports

🔔 Notifications

Select Your Name

My Budget

Awaiting Fund Release

Active Releases

Liquidated Releases

🔔 Notifications

My Fund Requests

Activity History

Staff

Setup Guide

Step 1 — Create a Firebase Project

Step 2 — Enable Realtime Database

⚠️ Step 2b — Fix Database Rules (IMPORTANT)

Step 3 — Get your Web App Config

Step 4 — Paste Config into this HTML file

Step 5 — Set Your Owner PIN

Step 6 — Share with your Team

Budget Monitoring

Owner Access

Budget Monitoring

Fund Requests

Liquidation Requests

Awaiting Fund Release

Active Releases

All Releases

Liquidated Releases

Team Members

Expense Codes

Expense Reports

🔔 Notifications

Select Your Name

My Budget

Awaiting Fund Release

Active Releases

Liquidated Releases

🔔 Notifications

My Fund Requests

Activity History

Staff

Setup Guide

Step 1 — Create a Firebase Project

Step 2 — Enable Realtime Database

⚠️ Step 2b — Fix Database Rules (IMPORTANT)

Step 3 — Get your Web App Config

Step 4 — Paste Config into this HTML file

Step 5 — Set Your Owner PIN

Step 6 — Share with your Team

📩 Add Fund Request

✏️ Edit Release

✏️ Edit Fund Request

📂 Add Expense Code

👤 Add Team Member

✅ Mark as Liquidated

📋 Request Liquidation

📩 Request More Funds

⚙️ App Settings

➕ Add Amount to Release

📋 Add Expense

💬 Direct Messages

👥 Group Chats

👥 Create Group Chat

↩ Return Request

Fund Details

🔒 Change PIN

🔒 Change Owner PIN

📖 Staff User Guide