Skip to main content

​
Overview

Groups are the foundation of expense splitting in Divvy. Each group represents a shared space where members can track expenses, view balances, and settle up.

​
Creating a Group

To create a new group:
  1. Tap the Create Group button from the Groups screen
  2. Enter a group name (e.g., “Roommates”, “Weekend Trip”)
  3. Choose an icon to represent your group
  4. Tap Create to finish
You’ll be automatically added as the group creator and can start adding members right away.

​
Group Icons

Personalize your groups with custom icons. Choose from a variety of categories including:
  • Food & dining
  • Travel & vacation
  • Home & utilities
  • Entertainment
  • And many more
Icons help you quickly identify groups at a glance in your group list.

​
Adding Members

There are two ways to add members to your group:

​
Editing Group Details

As the group creator, you can edit group information:
  1. Open the group from your Groups list
  2. Tap Edit Group
  3. Update the group name or icon
  4. Tap Save Changes
All group members will see the updated name and icon immediately.

​
Viewing Member Balances

The group detail screen shows a summary of balances for all members:
  • Settled up: The member’s share is fully paid (balance = $0.00)
  • Owes you: The member owes money for expenses you covered
  • You owe: You owe money for expenses they covered
Tap any member card to expand settlement options and mark payments.

​
Group Balance Summary

At the top of each group, you’ll see your overall balance:

You are owed

Displayed in green when you’ve paid more than your share of group expenses.

You owe

Displayed in red when others have covered more than their share.

​
Managing Groups

Access group management options from the menu (⋮):
  • Copy invite link: Share with new members
  • Leave group: Remove yourself from the group
  • Delete group (creator only): Permanently delete the group and all its data
Deleting a group cannot be undone. All expenses, balances, and history will be permanently removed.

​
Group Data Model

Under the hood, each group contains: 
data class Group(
    val id: String,
    val name: String,
    val emoji: String,
    val icon: GroupIcon,
    val memberCount: Int,
    val balanceCents: Long,      // Your net balance in this group
    val currency: String,         // Default: "USD"
    val createdBy: String         // User ID of creator
)
Key Properties:
  • balanceCents: Positive values mean you’re owed money, negative means you owe
  • memberCount: Total number of members including yourself
  • icon: Enum representing the visual icon (stored in ~/source/app/src/main/java/com/example/divvy/components/GroupIcon.kt)
Reference: ~/workspace/source/app/src/main/java/com/example/divvy/models/Group.kt:7

Build docs developers (and LLMs) love

Get started for freeTalk to us