PoolPay
Get the App
Home / How It Works

From sign-in to settled

A complete walkthrough of the PoolPay journey — every screen and the actions behind it.

The core loop

Four steps to clarity

1

Authenticate

The splash screen validates your stored JWT. Valid tokens go straight home; otherwise you land on login.

2

Set up & create

First-timers complete a profile, then create group or personal rooms with a color, name, and optional PIN.

3

Log & track

Post expenses to the chat feed; balances recalculate live for everyone in the room.

4

Settle & reward

Settle dues individually or in bulk, raise your credit score, and earn monthly certificates.

Screen by screen

Every screen, explained

Placeholder visuals below — swap each for a real exported app screenshot before launch.

Home screen with group rooms
Home — Group RoomsGrid of room cards with role badges and member counts. A top-right menu creates rooms, opens your profile, invites roommates, or contacts support.
Personal direct rooms list
Home — PersonalA list of direct 1-on-1 chats showing initials, the last transaction, and time elapsed. Tap to open a direct dashboard.
Room dashboard feed
Room DashboardLive stats card plus a scrollable feed of transaction bubbles. Tap the room name to open settings; long-press a bubble to multi-select.
Multi-select mode
Multi-Select ModeLong-press an unsettled bubble to select. The input hides and a floating bar appears to copy notes or settle all at once.
Personal dashboard
Personal Dashboard"You Owe", "Friend Owes", "Settled", and a net status. Toggle inputs flip between who owes whom with amount and note fields.
Top spender certificate
Top Spender CertificateA gold-trimmed award card with the certified name, total spent, and Room Credit Score box — shareable to the clipboard.
Under the hood

What each screen does

1

Splash & Login

The splash screen verifies your stored token. The login screen offers a single, secure "Continue with Google" button — on success it stores your access token and checks whether your profile is complete.

2

Complete Profile

First-time users provide a full name, mobile number, gender, and date of birth. PoolPay updates the backend record before granting access to the home dashboard.

3

Home & Room Creation

Switch between Group Rooms and Personal tabs. The Create Room dialog sets a color theme, room name, optional description, and a PIN/passcode lock toggle.

4

Dashboard & Settlement

Log expenses and income in the chat feed. Long-press to enter multi-select mode for bulk settlement; settled items are locked from re-selection so records stay accurate.

5

Settings & Members

Rename the room, pick from a palette of 10 theme colors, manage members and roles, toggle per-member permissions, and remove members, leave, or delete the room.

6

Profile & History

Manage your details and review previous rooms — including countdowns for permanent deletion and rejoin windows — with recovery buttons. Logout safely clears secure storage.

Good to know: the backend runs on a free hosting tier, so the very first launch may pause on the splash screen for up to 30–50 seconds while the server spins up. PoolPay waits patiently instead of bouncing you back to login.
End-to-end flow

The complete application workflow

Start App → Is the JWT token valid?

↳ Yes → Home Screen

↳ No → Login → Google Auth → New user? → Complete Profile → Home

Home → Create Room dialog · Tap a room → Dashboard · Profile icon → Profile

↳ Dashboard → Add transaction · Long-press → Multi-Select → Confirm → Bulk Settle

↳ Dashboard → Room header → Settings → Invite roommates → Add Member dialog

Profile → Logout → Reset secure storage → Login

Try the flow yourself

Download PoolPay and create your first room in under a minute.

Get the App Browse Features