Home

Welcome to the CrewSplit wiki!

CrewSplit is a deterministic, family-focused trip expense-splitting app built with Expo (Android & iOS).

Core Principles

1. Deterministic: Same inputs always produce same outputs.
2. Local-first: Fully functional offline.
3. Auditable: All computations are traceable to source data.
4. Zero friction: Minimal input, maximum clarity.

Features

• Trip Management: Create and manage trips with custom currencies and date ranges.
• Expense Tracking: Track expenses with categories, custom splits, and multi-currency support.
• Smart Settlement: Automatic calculation of who owes whom using a transaction minimization algorithm.
• Participant Management: Add participants with color-coded avatars.
• Display Currency: View all amounts in your preferred currency with real-time conversion.
• Offline-First: Full functionality without an internet connection.

Downloads

Release artifacts are published as APK files named with semantic versions. crewsplit-vX.Y.Z.apk

Issues and Feedback

Open a GitHub issue to report bugs, request features, or ask questions.

Documentation Map

End-user guides are listed first. Developer and architecture references are listed second.

End User Docs

• Getting Started: Install, create your first trip, and add your first expense.
• Trips: Create trips, manage participants, and configure trip settings.
• Expenses: Add expenses, choose payers, and customize splits.
• Settlement: Read balances and understand suggested payments.
• Offline and Backup: Local-first storage, exports, and optional sync.
• FAQ: Quick answers to common questions.

Developer Docs

• Architecture & Agents: Understand the role-based agent system and module structure.

• Documentation Overview: Entry point for developer documentation links.

• Developer Guidelines: Coding standards, testing strategies, and workflow rules.

• Settlement Module Overview: Deep dive into the pure math engine.

• FX Implementation Summary: Details on the multi-currency architecture.

• Onboarding Quick Start: Implementation order and key files for onboarding.

• Participants Module Overview: Structure, queries, and responsibilities.

• Settlements Index: Entry point for settlement feature documentation.

• FX Schema Quick Reference: Schema and query quick card for FX rates.