Mobile app overview

The Soundcheck mobile app is a React Native application built with Expo SDK 57, designed specifically for live event professionals.

Features

Core screens

Screen	Description
Gigs	Your events and gig details (Expo Router route: `app/(tabs)/events`)
Mailbox	Invitations, crew offers, and availability checks (engagements)
Browse	Organization modules: setlists, songs, CRM, teams, tasks, files, and more
You	Profile, personal settings, and organization settings (including availability hours)

Authentication

Clerk Authentication with email/password, Google OAuth, and Apple Sign In (platform-specific; see Authentication)
iOS: native Apple Sign In and Google OAuth
Android: Google OAuth only on native (SsoButtons.android.tsx; no Apple button)
Web (Clerk): Google and Apple OAuth
Secure user management and session handling
Automatic login state persistence
Token caching with SecureStore

Performance features

Tab Preloading - All tabs load instantly for smooth navigation
Smart Data Refetching - Fresh data when switching between tabs
Intelligent Caching - 5-minute cache to reduce API calls
Pull-to-Refresh - Manual data refresh on all screens
React.memo Optimization - Efficient component re-rendering

Design system

Custom UI Kit - NativeWind v4 + @rn-primitives in components/ui
Inter Font Family - Professional typography with multiple weights
Platform-Aware Styling - Optimized for iOS and Android
Light and dark themes - userInterfaceStyle: automatic in app.config.js; ThemeContext resolves a persisted System (default) / Light / Dark preference from You → Settings → Appearance
Consistent Theme - Purple-based color scheme (#9b87f5)

Technology stack

Core technologies

Technology	Version	Purpose
React Native	0.83.6	Cross-platform mobile development
Expo SDK	55	Development and build tooling
TypeScript	5.3.0	Type-safe development
Expo Router	~55	File-based navigation

Authentication and backend

Technology	Purpose
@clerk/expo ^3.2	Authentication and user management
Google OAuth	Social login integration
Apple Sign In	iOS-native authentication
Expo Secure Store	Secure credential storage

UI and performance

Technology	Purpose
NativeWind v4 + `@rn-primitives`	Design system and UI primitives (`components/ui`)
React Navigation 7.0	Native navigation patterns
Ionicons	Consistent icon system
React Native Gesture Handler	Smooth gestures
React Native Reanimated	High-performance animations

Project structure

[REDACTED]-mobile-app/
├── app/                          # Expo Router pages
│   ├── (tabs)/                   # Tab navigation screens
│   │   ├── events/               # Gigs tab (route name; tab label is "Gigs")
│   │   ├── mailbox/              # Mailbox (invitations, offers, availability checks)
│   │   ├── browse/               # Browse modules
│   │   └── you/                  # Profile and settings (incl. availability hours)
│   ├── _layout.tsx               # Root layout with providers
│   ├── index.tsx                 # App entry point
│   ├── login.tsx                 # Login screen
│   └── signup.tsx                # Registration screen
├── components/                   # Reusable UI components
│   ├── ui/                       # Design-system primitives
│   ├── events/                   # Event-specific components
│   └── shared/                   # Shared UI components
├── constants/                    # App constants
│   └── theme/                    # Design system tokens
├── lib/                          # Core library code
│   ├── context/                  # React Context providers
│   ├── hooks/                    # Custom React hooks
│   ├── api/                      # API service layer
│   └── utils/                    # Utility functions
└── assets/                       # Static assets
    ├── icon.png                  # App icon
    ├── splash.png                # Splash screen
    └── adaptive-icon.png         # Android adaptive icon

Post-auth redirects use /(tabs)/events, which is the Gigs tab in the UI.

Configuration

App configuration

Setting	Value
Bundle ID	`com.[REDACTED].app`
Version	1.1.169
Platforms	iOS, Android
Orientation	Portrait only
userInterfaceStyle	automatic

Theme configuration

Token	Value
Primary Color	#9b87f5 (Purple)
Font Family	Inter
Border Radius	4px, 8px, 12px, 16px, 24px
Spacing	4px, 8px, 16px, 24px, 32px, 48px, 64px

Development commands

Daily development

npm start          # Start Expo development server
npm run ios        # Run on iOS simulator
npm run android    # Run on Android emulator
npm run web        # Run in web browser

Quality checks

npm run type-check      # TypeScript type checking
npm run lint            # Run oxlint
npm run lint:fix        # Fix linting issues
npm run format:check    # Check formatting with oxfmt
npm run check-all       # Run all checks

Building

npm run build:ios       # Build iOS with EAS
npm run build:android   # Build Android with EAS
npm run submit:ios      # Submit to App Store
npm run submit:android  # Submit to Play Store

Next steps

Setup Guide

Complete mobile development setup

iOS Setup

iOS-specific development setup

Android Setup

Android emulator configuration

Architecture

App architecture and patterns

Overview

Backend

Backend integrations

API reference

Frontend

Mobile

Infrastructure

CI/CD

Development

Guides

Reference

Features

Core screens

Authentication

Performance features

Design system

Technology stack

Core technologies

Authentication and backend

UI and performance

Project structure

Configuration

App configuration

Theme configuration

Development commands

Daily development

Quality checks

Building

Next steps

Setup Guide

iOS Setup

Android Setup

Architecture

​Features

​Core screens

​Authentication

​Performance features

​Design system

​Technology stack

​Core technologies

​Authentication and backend

​UI and performance

​Project structure

​Configuration

​App configuration

​Theme configuration

​Development commands

​Daily development

​Quality checks

​Building

​Next steps

Setup Guide

iOS Setup

Android Setup

Architecture

Features

Core screens

Authentication

Performance features

Design system

Technology stack

Core technologies

Authentication and backend

UI and performance

Project structure

Configuration

App configuration

Theme configuration

Development commands

Daily development

Quality checks

Building

Next steps