EvenShare - Split and Settle Bills App

Let your app's users split any bill, trip, or shared cost evenly between friends, family, or roommates — and know exactly who still owes what. EvenShare gives you a ready-to-build React Native + Expo template with a real two-step settlement flow: participants mark their own share paid, and the organizer confirms it's actually been received, so nothing gets marked "done" on trust alone.

Built with Supabase (Postgres, Auth, Row Level Security) and Expo Router, EvenShare includes full authentication, a drawer-navigation UI, an "action needed" indicator system so nobody has to hunt for what's outstanding, and a clean, themeable design — ready to rebrand and ship as your own expense-splitting app, or extend into a bigger finance tool.

Features

- Two-step settlement ledger: pending → paid → confirmed, with separate participant and organizer permissions at each step - Full authentication flow (sign up, sign in, complete-profile safety net) - Supabase Postgres backend with Row Level Security policies enforced at the database level, not just hidden UI - Drawer navigation built with Expo Router - "Action needed" indicators at both the list and detail level, for organizers and participants - Even-split bill creation with participant lookup by email - Organizer profile with live stats (pots organized, pots joined, join date) - Fully themeable design system (colors, spacing, typography tokens) - Cross-platform alert handling (native + web) - Works on iOS, Android, and web (Expo web export included)

Requirements

• Node.js 20.19.4 or newer and npm for Expo SDK 54.
• A Supabase project for PostgreSQL, authentication and Row Level Security.
• A compatible Expo development environment; Android 7 or newer, or iOS 15.1 or newer.
• An Expo/EAS account and platform publishing accounts for signed store releases.
• React Native and SQL knowledge for customization.

Instructions

1. Read README.md and SETUP_GUIDE.md, then run npm install.
2. Copy .env.example to .env and enter your Supabase URL and public anon key.
3. Run supabase/migrations/001 through 006 in order in the Supabase SQL Editor.
4. Use npx expo start for development or npx expo export --platform web for the web version.
5. Follow SETUP_GUIDE.md to change app.json identifiers, icons, splash assets and ThemeContext styling, then configure EAS for signed Android or iOS releases.