Download & Install

1. Open Google Play Store and search for FlatFlow
2. Tap Install and open the app
3. Choose Register New Apartment (admin) or Login to Existing Apartment (residents)

Requires Android 7.0 or higher. The admin must have an active subscription before residents can log in.

Financial Overview Card

The blue card at the top shows the current billing period summary:

• Collected — total confirmed payments received from flats
• Expenses — total recorded society spends
• Balance — net (collected minus expenses)
• Collection Progress — X of Y flats paid this cycle

Fund Balances

Three live tiles below the overview show current balances for Maintenance, Festival Fund, and Corpus Fund. These update automatically with every recorded payment or expense.

Quick Actions

One-tap shortcuts to the most frequent tasks: Add Payment, Add Expense, Manage Flats, Corpus Fund, Summary, and Water Bill.

Generating Dues for All Flats

1. Tap Add Payment from Quick Actions on the home screen
2. Select Fund Type — Maintenance, Festival, or Corpus
3. Select Request Type — All Flats or Individual Flat
4. Optionally Exclude specific flats (e.g. vacant ones)
5. Tick Set a custom amount if different flats pay different amounts
6. Enter a Description (e.g. "July maintenance")
7. Tap Generate for All Flats

FlatFlow creates individual payment records for every flat and sends push notifications to all residents immediately.

Corpus Fund Screen

Tap Corpus Fund from Quick Actions. The screen shows:

• Current Balance — large green card at the top (e.g. ₹6.00L)
• Per-flat contribution summary at the top
• All Entries — chronological list of contributions (green, +) and withdrawals (red, –)
• Each entry shows flat name, owner, amount, and date

Adding a Contribution

1. Tap + Add Contribution
2. Select the flat and enter the amount and notes
3. Tap Save — the balance updates immediately

Adding an Expense

1. Tap Add Expense from Quick Actions or the Expenses screen
2. Select Fund Type — Maintenance, Festival, or Corpus
3. Choose a Category from the dropdown (Electricity, Repairs, Watchman Salary, Garbage Collection, Miscellaneous, etc.) or type a custom one
4. Enter the Amount
5. Select the Date
6. Add Notes — bill number, vendor name, description
7. Tap Save Expense

The expense is immediately visible to all residents in their Expenses screen and the fund balance adjusts automatically.

Record expenses as they occur — not in bulk at month-end. Real-time recording keeps fund balances accurate for both admin and residents.

Manual Entry (Primary Method)

FlatFlow shows all your flats with the previous month's meter reading already filled in. Just type the current reading for each flat — consumption and bill amount calculate automatically.

1. Tap Water Bill from the More menu
2. Select the Month and Year
3. The ₹ per unit price is pre-filled from last month — update it if the rate changed
4. All flats are listed with the previous month reading already shown
5. Type the current meter reading for each flat — consumption and amount update instantly
6. Tap Request Water Bill Payment to generate bills for all entered flats

FlatFlow saves the readings after each generation, so they automatically appear as "previous reading" the following month.

You can enter readings for any number of flats — flats you skip are excluded from that month's bill. The rate per unit from the previous month is remembered automatically.

Import from CSV (Alternative)

If you prefer to work from a spreadsheet, tap Import from CSV to upload a readings sheet. Tap Manual to switch back to the inline entry mode.

Request Water Bill Payment

Once readings are complete, tap Request Water Bill Payment to generate payment requests for all entered flats at once. Each flat's resident gets notified of their bill amount.

The price per unit is automatically remembered from the last time you generated a water bill. Update it in the price field if the rate has changed this month.

How the Combined Bill Works

Instead of sending two separate payment requests (water bill + maintenance), you can merge them into one. Residents pay a single amount and see the breakdown clearly.

1. Tap Water Bill from Quick Actions
2. Select the Month and Year, set the rate, and upload your CSV sheet as usual
3. Tick the "Maintenance + Water Bill" checkbox that appears below the upload button
4. Optionally enter a custom maintenance amount to override the per-flat default (leave blank to use each flat's configured amount)
5. Tap Request Combined Bill Payment

Each flat receives one payment request for the combined total. The payment tile shows the breakdown: Water ₹X + Maint. ₹Y.

Enabling the combined bill replaces the standalone water bill for that month — existing water bill requests for the same month are replaced. Maintenance dues generated on the 1st are separate and unaffected.

Creating a Custom Fund Type

Presidents and Treasurers can add custom fund types from the Profile screen.

1. Go to Profile → Fund Types
2. Tap + Add Fund Type
3. Enter a name (e.g. "Temple Fund")
4. Pick a color from the preset palette
5. Tap Add — the fund type is instantly available across the app

To remove a custom type, tap the delete icon next to it. Built-in types (Maintenance, Festival, Corpus) cannot be deleted.

Custom fund types are apartment-wide — all admins in your apartment see and use the same list.

Built-in Roles

FlatFlow ships with four fixed roles that cannot be deleted:

• President — full access to everything including roles, users, and settings
• Treasurer — manages payments, expenses, corpus fund, and reports
• Maintainer — manages flats, water bills, notices, and maintenance payments
• Owner (Resident) — pays dues, raises service requests, views society financials

Creating a Custom Role

The President can create any number of custom roles with hand-picked permissions:

1. Go to More → Roles
2. Tap the + New Role button
3. Enter the role name (e.g. Secretary, Security Head)
4. Pick a colour for easy identification
5. Check the permissions to grant: Manage Payments, Manage Expenses, Manage Water Bill, Manage Flats, Manage Corpus, Send Notices, View Reports, Manage Users
6. Tap Create

Assigning a Role to a Flat Owner

1. Open More → Roles and expand the role card
2. Tap Assign — a list of flat owners who don't yet hold any role appears
3. Select the owner to appoint

One person holds one role at a time. To change someone's role, revoke their current one first, then assign the new one.

Custom role holders appear in the app as admins and can access the features their permissions allow. Their role name is shown in Manage Users and on their profile.

How It Works

FlatFlow supports one owner account linked to multiple flat numbers. When a flat is imported via CSV and the owner's phone number already has an account in the society, their new flat is automatically added to their existing profile.

• The owner logs in once and sees dues for all their flats in the My Dues screen
• Payment submission applies to whichever flat the due belongs to
• Admins see each flat's records separately in Manage Payments and Reports

Registering Multiple Flats via CSV

1. Go to More → Manage Flats → Import CSV
2. Include all the flat rows for the same owner with the same phone number
3. FlatFlow detects the existing account and links the additional flat automatically — no duplicate accounts created

A person with multiple flats pays each flat's dues independently. Water bills and maintenance are raised per flat, and the owner can settle them individually from their single login.

Sending a Reminder to a Flat

From the Reports screen, tap any flat with pending dues. A reminder dialog appears showing a full breakdown of what the flat owes:

• Current month dues (Maintenance, Water Bill, Festival)
• Previous months' unpaid dues
• Total Pending amount
• A pre-written reminder message with the full breakdown

1. Review the pending dues breakdown
2. Tap Send Reminder — a push notification is sent to the flat owner instantly

The reminder message is generated automatically with the exact amounts. The resident sees the notification on their phone with the full dues breakdown.

Managing Service Tickets

The Help Desk screen shows all tickets filtered by status: Active, Open, In Progress, Resolved, Closed.

• Each ticket shows the flat number, issue type, date, and current status
• Tap a ticket to see full details and update its status
• Once fixed, mark it Resolved
• After confirmation, tap Close Ticket

Residents can track the status of their own requests in real time from their Help Desk tab.

Posting an Announcement

1. Go to Notices from the bottom navigation
2. Tap + New Announcement
3. Enter a Title (e.g. "Meeting next Sunday")
4. Write the Content — meeting agenda, maintenance notice, visitor policy, etc.
5. Tick Pin this announcement to keep it at the top for all residents
6. Tap Post Announcement

All residents see the notice in their Notices tab and receive a push notification. Pinned notices stay visible at the top until unpinned.

The Flats List

The Manage Flats screen (Quick Actions → Manage Flats) shows all registered flats with owner name, phone number, BHK type, occupancy status, and monthly maintenance amount.

• Add a flat — tap + Add Flat, enter flat number, owner name, mobile number, BHK, monthly amount
• Edit or delete — swipe left on any flat to reveal Edit and Delete options
• Import in bulk — tap the CSV import icon to upload all flats from a spreadsheet at once

A resident's mobile number is their login credential. The number you enter here must match the number they use to sign in.

My Profile

Access via the More tab → Profile. Shows your name, role (President), flat number, and registered phone. From here:

• Change Password — update your login credentials
• Fund & Balance Settings — set opening balances and per-flat default maintenance amounts for each fund
• About FlatFlow — current app version (v1.4.1 build 44)
• Logout — sign out of the admin account

How to Subscribe

1. Open the app as Admin → More tab → Subscription
2. Choose your plan tier: Basic (50 flats) or Premium (250 flats)
3. Select a duration (1, 3, 6, or 12 months)
4. Pay via UPI or card through the secure Cashfree payment gateway
5. Subscription activates immediately after payment verification

A reminder notification is sent 7 days before expiry. If the subscription lapses, residents can still view historical data but the admin cannot generate new dues or record expenses until renewed.

The subscription covers the whole society — one fee, all flats. No per-resident or per-flat charge.