Skip to main content

​
Overview

Analytics provides insights into your spending across all groups. See where your money goes, how much you’ve contributed, and identify spending trends.

​
Accessing Analytics

Tap the Analytics tab in the bottom navigation to view your spending dashboard.

​
Total Group Spending

The top card displays your aggregate spending across all groups: 
Total group spending
$1,247.50
23 expenses across all groups
This represents the sum of all expense totals in groups you belong to, regardless of who paid.

​
Key Metrics

Two stat cards show your personal financial breakdown:

Your share

The total amount of all expenses that you’re responsible for (your portion of split costs).Example: $432.80

You paid

The total amount you’ve actually paid out-of-pocket for expenses (regardless of split).Example: $485.20

​
Understanding the Difference

  • Your share: What you should pay based on splits
  • You paid: What you actually paid upfront
  • Difference: The gap between these determines if you’re overpaying or underpaying

​
Overpaid/Underpaid Summary

This card shows the net difference between what you paid and your actual share:
“You’ve overpaid by $52.40”
  • Displayed in green
  • Means you fronted more money than your share of expenses
  • Others owe you to balance things out
  • Subtitle: “You fronted more than your share”
Calculation: 
Overpaid amount = (You paid) - (Your share)

Example:
You paid: $485.20
Your share: $432.80
Overpaid by: $52.40
Reference: ~/workspace/source/app/src/main/java/com/example/divvy/ui/analytics/Views/AnalyticsScreen.kt:207

​
Spending by Group

This section breaks down your expenses by each group you belong to.

​
Group Spending Cards

Each group displays:
  • Group icon: Visual identifier
  • Group name: “Roommates”, “Weekend Trip”, etc.
  • Your share: Your portion of expenses in this group
  • Group total: Total spending across all members
  • Progress bar: Visual representation of your share relative to the highest-spending group
Example: 
[🏠] Roommates
Group total: $845.30
                                              $312.40
[████████████████░░░░░░] 60% of max spending
Reference: ~/workspace/source/app/src/main/java/com/example/divvy/ui/analytics/Views/AnalyticsScreen.kt:252

​
Visual Scaling

The progress bars are normalized to the group with the highest spending:
  • The group where you’ve spent the most shows a full bar (100%)
  • Other groups scale proportionally
  • Bars animate smoothly when the screen loads

​
Sorting

Groups are displayed in order of your total share (highest to lowest).

​
Data Breakdown

Analytics aggregates data from:
  1. All expenses across your groups
  2. Your splits within those expenses
  3. Who paid for each expense
  4. Settlement history (reduces outstanding balances)

​
Activity Feed Reference

While analytics shows aggregate numbers, you can see individual transactions in:
  • Group activity feeds: Shows recent expenses per group
  • Ledger: Complete transaction history across all groups
See Ledger for detailed transaction views.

​
Analytics Data Model

The analytics view model calculates: 
data class GroupSpending(
    val groupId: String,
    val groupName: String,
    val groupIcon: GroupIcon,
    val yourShareCents: Long,     // Your portion of group expenses
    val totalCents: Long          // Total group spending
)
Key calculations:
  • Total spent: Sum of all Expense.amountCents across groups
  • Your share: Sum of all Split.amountCents where userId = you
  • You paid: Sum of all Expense.amountCents where paidByUserId = you
  • Overpaid: (You paid) - (Your share)
Reference: ~/workspace/source/app/src/main/java/com/example/divvy/ui/analytics/ViewModels/AnalyticsViewModel.kt

​
Use Cases

​
Budget Tracking

Monitor your total group spending to stay within budget:
  • Set personal spending limits
  • Track monthly group expenses
  • Identify which groups cost the most

​
Expense Patterns

Understand where your money goes:
  • See if one group dominates your spending
  • Compare spending across roommates, trips, or events
  • Analyze personal vs. group spending habits

​
Settlement Planning

Use overpaid/underpaid metrics to:
  • Identify who to settle up with
  • See if you need to request money or send payments
  • Balance out-of-pocket costs with actual obligations

​
Future Enhancements

Planned analytics features:
  • Date range filters: View spending for specific time periods
  • Category breakdown: Expenses by type (food, travel, utilities)
  • Export options: Download spending reports as CSV/PDF
  • Charts and graphs: Visual spending trends over time

​
Empty State

If you have no expenses yet:
  • Analytics will show $0.00 for all metrics
  • The spending by group section will be empty
  • Add expenses to start seeing analytics
Analytics update in real-time as you add expenses and settle balances.