Repository navigation
Mobile Overview
apps/mobileAppYC is the pet-owner mobile app - React Native CLI (RN 0.81, React 19), Redux Toolkit, React Navigation 7. This section walks its architecture; the code in apps/mobileAppYC/src is canonical.
Companion pages: Auth, Navigation, Bootstrap · Appointments & Discovery · Companion, Co-Parent, Documents · Tasks, Observations, Expenses · Chat, Notifications, Adverse Events · Shared Components & UI · Build: iOS & Android · Testing.
| Concern | Choice |
|---|---|
| Framework | React Native CLI 0.81.6 (with a repo patch) / React 19.1.4 |
| State | Redux Toolkit 2.12 + redux-persist
|
| Navigation | React Navigation 7 (native-stack + bottom-tabs + drawer) |
| Auth | SuperTokens (supertokens-react-native) - passwordless OTP + Google/Apple social exchange; Firebase is push-only |
| Push | Firebase Cloud Messaging + Notifee |
| Payments | @stripe/stripe-react-native |
| Chat | stream-chat-react-native |
| Analytics | PostHog (opt-in) |
| i18n | i18next / react-i18next (en, es) |
| Forms | react-hook-form |
app/ Redux store (store.ts) + typed hooks (useAppDispatch/useAppSelector)
config/ variables.ts (API_CONFIG, feature flags, Stripe/PostHog config)
context/ app-wide React contexts (GlobalLoader, Auth, Preferences...)
features/ ~25 feature folders (as of 2026-08) - the core of the app
hooks/ shared-hook barrel
localization/ i18next setup + en/es resources
navigation/ root/tab/stack navigators + types.ts + FloatingTabBar
shared/ components/, hooks/, services/, stores/, utils/ - the reusable layer
theme/ design tokens + light/dark theme objects
Each domain lives under src/features/<domain>/ and typically owns: a Redux slice (createSlice({ name: '<domain>' })), thunks.ts (RTK createAsyncThunk), selectors.ts, types.ts, a services/ module (a thin wrapper over the shared axios client), plus screens/, components/, and hooks/. This keeps a feature's state, data access, and UI colocated.
src/app/store.ts combines 12 persisted slices - auth, theme, companion, documents, expenses, tasks, appointments, businesses, coParent, linkedBusinesses, notifications, forms - under redux-persist (key root, version 6 with a migrate function for v1→v6). Under Jest, AsyncStorage is swapped for in-memory storage. Types RootState / AppDispatch are exported and consumed via the typed hooks in src/app/hooks.ts.
index.js registers push background handlers before AppRegistry.registerComponent. App.tsx is the real bootstrap: it initializes SuperTokens (initSuperTokens from features/auth/services/superTokensClient.ts) and the social providers, loads remote mobile config (fetchMobileConfig), resolves the API base URL, evaluates the app-update prompt, initializes PostHog + Stripe, and mounts the provider tree (Provider → PersistGate → GestureHandlerRootView → SafeAreaProvider → AuthProvider → PreferencesProvider → GlobalLoaderProvider → AppUpdateGate → NotificationBootstrap → StripeProvider → NavigationContainer → AppContent). Details: Auth, Navigation, Bootstrap.
A central axios client (src/shared/services/apiClient.ts) carries the base URL, dev logging, Android localhost→10.0.2.2 normalization, and runtime base-URL swaps. Each feature's services/*Service.ts builds on it; remote runtime config comes from mobileConfig.ts.
src/theme/ defines the palette in colors.ts (brand #257BED, warm charcoal ink #302F2E, bone screen surface #F7F3EC, plus a full espresso dark set), typography, and spacing. Components read tokens via src/shared/hooks/useTheme.ts. Dark mode is live: useTheme resolves light or espresso dark from the persisted preference (and tracks the OS in "system" mode), returning darkModeLocked: false. semanticTokens.ts is a hand-maintained naming layer that application code does not import - the app does not depend on packages/design-tokens (see Design System and Tokens).
Home · Architecture · ADRs · Plans · Roadmap · Contributing · Main repo · DeepWiki · Discord
Yosemite Crew is a product of DuneXploration UG (haftungsbeschränkt). This wiki mirrors the repository; where a page and the repo disagree, the repo wins. See the Wiki Style Guide.
Product & Domain
Architecture
Applications
- Backend — Overview
- Frontend / PIMS Web — Overview
- Mobile — Overview
- Desktop PIMS Shell
- Developer Portal
- SuperAdmin
Design & Accessibility
Engineering Handbook
Decisions (ADRs)
Design Docs & Plans
Meta
Canonical code & docs: main repo · Auto-generated companion: DeepWiki