Housr App

Expo (React Native) mobile app for student housing discovery and management. Supports both UK and US markets, controlled at build time by the EXPO_PUBLIC_USA_MODE environment variable.

Stack: Expo SDK 54, React Native 0.81, React 19, TypeScript 5.9, React Query v5, Expo Router

Quick Start

npm install            # Install dependencies (runs patch-package via postinstall)
npm start              # Start Expo dev server
npm run ios            # Run on iOS simulator (requires native build)
npm run android        # Run on Android emulator
npm run web            # Run web preview
npm run lint           # ESLint
npm run format         # Prettier (src/**/*.{js,jsx,ts,tsx,json,css,md})
npm run storybook      # Component storybook on port 6006

Staging builds use EAS:

APP_VERSION=1.2.3 BUILD_NUMBER=1 npx eas build --profile uk-staging --platform ios --local

There is no test runner configured in this project.

Overview

The app covers:

• Explore — House discovery with map, search, filters, and likes
• Viewings — Viewing requests and inquiry management
• Bills — Utility bills quotes, signup, and meter readings (UK only)
• Promotions — Perks, events, and wallet (tokens + event tickets)
• Profile — Account management, house info, housemate invites
• Roomie — Roommate matching with profiles and chat
• Rideshare — Ride creation, search, booking, and chat

Documentation

Feature Docs