HouseMates

Smart shared living for housemates.

HouseMates replaces the messy combination of WhatsApp groups, spreadsheets, and Splitwise with one clean app built specifically for people sharing a home.

---

What It Does

• Bills — Track who paid what, see balances at a glance, get reminded before due dates
• Parking — See who has the spot, reserve it in advance, approve requests
• Groceries — Shared lists + personal lists, real-time sync
• Chores — Assign, rotate, track completion
• Tasks — House to-dos, notice board, shared notes
• Chat — House group chat + shared photo album

---

Status

Currently in private development for 3 housemates. Future: public App Store release.

---

Project Files

File	Purpose
CLAUDE.md	Root rules for all AI agents working on this project
FEATURES.md	Complete feature specification — what gets built
PHASES.md	Build order, phase goals, and workflow
AGENTS.md	Agent roles, skills, and communication rules
IDEAS.md	Future ideas and rejected concepts

---

Tech Stack

• React Native + Expo (iOS first)
• Supabase (database + auth + storage)
• TypeScript
• Zustand (state)
• React Native Paper (UI)

---

For New AI Agents

Read files in this order:

1. CLAUDE.md — rules and standards
2. FEATURES.md — what you're building
3. PHASES.md — where we are in the build
4. AGENTS.md — your specific role and rules