User Guide

Welcome to Paji Splitly! We are dedicated to solving the age-old awkward questions like "Who pays for this?" and "Who owes whom?" Whether it's a dinner with friends, couple's bookkeeping, or a group trip, we have the simplest and most intuitive solution for you.

๐Ÿš€ Quick Start

Step 1: Add Participants

  1. Add Participant: Click "Add Participant" on the home page and enter names (e.g., Alice, Bob).
  2. Import from Contacts: After logging in, you can select frequent friends directly from your "Address Book" to save time.
  3. Group Settings: Click the settings icon โš™๏ธ at the top right to rename the group or manage members.

Step 2: Record Expenses

Whether it's food, transport, or accommodation, record it instantly:

  1. Click the "Add Expense" button.
  2. Enter the Item Name (e.g., Pizza, Taxi) and Amount.
  3. Select Who Paid (Payer).
  4. Select Split Method (Who should share this cost).
    • Tip: Use the "Batch Add" feature to enter multiple receipts at once.

Step 3: Settlement

The system automatically calculates all debts and suggests the "Minimum Transfers" required.

  • View Results: In the "Settlement" section, see who owes whom.
    • <span style="color: #4caf50">Green</span>: Money others owe you (Receivable).
    • <span style="color: #f44336">Red</span>: Money you owe others (Payable).
  • Mark as Settled: After you pay your friend back, click the settlement card (or personal bill) and check "Mark as Settled" to clear the debt.
  • Partial Repayment: If you only pay part of it now, use "Partial Settle" in the personal bill and enter the amount. The remaining debt stays open.
  • Payer Edit Warning: If an expense has affected settlement history (including settled or repaid records), changing payer/amount/split rule will show a warning first with affected members and before/after changes.
  • Share Bill: Click the "Share" button to send the settlement results as an image or text to your group chat.

Step 4: Multi-user Collaboration

Tired of tracking expenses alone? Invite friends to join the group and track together!

  1. Get Invite Link: Click Settings โš™๏ธ at the top right, select "Invite Link" or "QR Code".
  2. Share with Friends: Send the link to your messaging group (e.g., WhatsApp, Messenger).
  3. Join Group: Friends click the link, select their name (or add a new one), and start collaborating.
  • All actions are synced in real-time. No more sending screenshots back and forth!

๐Ÿ›  Features

1. Flexible Split Modes

Not all costs need to be split equally. We support flexible rules:

  • Equal: Most common. Selected people split the cost equally.
  • Shares: Distribute by ratio (e.g., Couple = 2 shares, Single = 1 share).
  • Exact Amount: Specify exactly how much each person pays.
  • Percentage: Distribute by percentage (e.g., A pays 60%, B pays 40%).

2. Edit & Delete

Made a mistake?

  • Click the โœ๏ธ (Pencil Icon) on an expense item to edit amount, people, or notes.
  • Click the ๐Ÿ—‘๏ธ (Trash Icon) to delete the expense.
  • All actions have a "History", so you can Undo any accidental deletions.
  • If the expense is tied to settlement/repayment history, the editor shows a Before / After debt comparison to prevent accidental changes.

3. Smart Import

Have expense data in text format?

  • Paste Text: Paste text (e.g., Lunch, 120) and the system parses it automatically.
  • File Upload (Premium): Upload CSV or text files for batch processing.

4. Lucky Draw

Who buys the drinks? Who takes out the trash?

  • Use the "Lucky Draw" feature to randomly select one (or more) lucky winners.
  • Fair, transparent, and fun.

5. Personal Stats

Want to know how much you spent on this trip?

  • Check the "Personal Stats" report, including:
    • Total Paid: The actual amount you paid out of pocket.
    • Lent / Borrowed: Your current net position.
    • Top Interactions: See who is your biggest creditor or debtor.

6. Cloud Sync (Login Required)

  • Real-time Collaboration: Share the link with friends so everyone can add expenses from their own phones simultaneously.
  • Data Security: Data is stored in the cloud, safe from phone switches or cache clearing.

๐Ÿ’ก Common Scenarios

Scenario A: Simple Dinner (Equal Split)

Situation: Alice, Bob, and Carol have hotpot for $150. Alice pays first.

  • Action: Add expense $150, Payer: Alice, Split by: Alice, Bob, Carol (Equal).
  • Result: Bob gives Alice $50, Carol gives Alice $50.

Scenario B: Paid for Someone Else (Reimbursement)

Situation: Alice buys a movie ticket ($30) for Bob. Alice pays, but it's for Bob.

  • Action: Add expense $30, Payer: Alice, Split by: Only check Bob.
  • Result: Bob owes Alice $30.

Scenario C: Couple/Family Trip (Shares)

Situation: Alice (with husband, 2 people) and Bob (single, 1 person) travel. Bob pays $300 for hotel.

  • Action:
    • Payer: Bob.
    • Split Mode: "Shares".
    • Set Weights: Alice = 2, Bob = 1.
  • Result: Alice owes Bob $200.

Scenario D: Complex Shopping (Mixed)

Situation: A, B, C go shopping. A pays total $210.

  • Tissue $100 (Shared by all).
  • A's snacks $50.
  • B and C's drinks $60.
  • Tip: Enter as 3 separate items or use "Batch Add".
    1. Tissue 100 -> Split A, B, C
    2. Snacks 50 -> Split A
    3. Drinks 60 -> Split B, C
  • Result: The system sums up everyone's share and calculates final debt.

Scenario E: Edited Expense After Settlement (Direction Reversal)

Situation: Originally B paid $100, so A owed B $50, and A marked it as settled. Later, the expense is corrected to B actually paid only $50.

  • System behavior:
    1. A warning appears first, showing affected members (A, B) and the before/after comparison.
    2. Existing "settled" records are treated as real repayment cash flow during recalculation, not just removed as a tag.
  • Result: It can flip from "A owes B" to "B owes A"; in this case it becomes B owes A $25.

โ“ FAQ

Q: What about decimals in settlement? A: The system keeps decimals by default. We recommend rounding to the nearest whole number when actually transferring money.

Q: I paid my friend. How do I clear the debt? A: Click on the debt item (or friend's name) in the settlement section to open details, then check "Mark as Settled".

Q: Can I export to Excel? A: Currently we support exporting as Image or Text summary. Excel export is coming soon.

Q: Why did my data disappear? A: If not logged in, data is only stored in browser cache. We strongly recommend logging in to ensure data persistence and sync across devices.

๐Ÿ“ž Contact Us

If you have suggestions or find bugs, please email: paji.contact [at] gmail [dot] com