How maximcoding/react-native-bare-starter works
This is a bare React Native starter with a sample Hacker News feed, authentication, user-profile, and settings flows. Users enter through the app shell, which provides navigation and shared providers; feature screens use hooks and services to fetch or mutate data. Shared infrastructure supplies query policy, pluggable transport, offline queueing, persistence, theming, and localization. The README documents the broader starter capabilities; source excerpts and index references support the specific internal links shown. Unsampled settings and adapter behavior is represented only at subsystem level.
Main entry points: App.tsx Application shell · transport.ts Offline-aware transport · NavigationRoot.tsx Navigation flows · auth.service.ts Authentication service
Components 24
App and navigation
- Application shell
App.tsx - Navigation flows
src/navigation/NavigationRoot.tsx - Route definitions
src/navigation/routes.ts - Navigation persistence
src/navigation/persistence/navigation-persistence.ts
Product features
- Authentication screen
src/features/auth/screens/AuthScreen.tsx - Authentication service
src/features/auth/services/auth/auth.service.ts - Home and story screens
src/features/home/screens/HomeScreen.tsx - Feed query
src/features/home/hooks/useFeedQuery.ts - Hacker News service
src/features/home/services/hn/hn.service.ts - Settings and onboarding
src/features/settings/screens/SettingsScreen.tsx - Current-user query
src/features/user/hooks/useMeQuery.ts
Shared platform
- MMKV storage
src/shared/services/storage/mmkv.ts - Zustand storage adapter
src/shared/services/storage/zustand-mmkv-storage.ts - Theme provider
src/shared/theme/ThemeProvider.tsx - Typed localization
src/i18n/i18n.ts - Sentry monitoring
src/shared/services/monitoring/sentry.ts
Data and connectivity
- Query provider
src/shared/services/api/query/client/provider.tsx - Query client policy
src/shared/services/api/query/client/query-client.ts - Offline-aware transport
src/shared/services/api/transport/transport.ts - REST adapter
src/shared/services/api/transport/adapters/rest.adapter.ts - Offline mutation queue
src/shared/services/api/offline/offline-queue.ts - Offline sync engine
src/shared/services/api/offline/sync-engine.ts
Other components
- App user
- Hacker News API
Connections 23
- App user → Application shell: uses
README.md - Application shell → Navigation flows: renders
App.tsx - Application shell → Theme provider: provides theme
App.tsx - Application shell → Query provider: provides queries
App.tsx - Application shell → Typed localization: loads
App.tsx - Application shell → Sentry monitoring: initializes
App.tsx - Application shell → REST adapter: selects adapter
App.tsx - Navigation flows → Navigation persistence: persists state
src/navigation/NavigationRoot.tsx - Navigation flows → Route definitions: uses routes
- Authentication screen → Authentication service: submits credentials
- Authentication service → Offline-aware transport: mutates
src/features/auth/services/auth/auth.service.ts - Authentication service → MMKV storage: stores tokens
src/features/auth/services/auth/auth.service.ts - Home and story screens → Feed query: loads feed
- Feed query → Hacker News service: fetches feed
src/features/home/hooks/useFeedQuery.ts - Hacker News service → Hacker News API: requests stories
src/features/home/services/hn/hn.service.ts - Current-user query → Offline-aware transport: queries profile
src/features/user/hooks/useMeQuery.ts - Query provider → Query client policy: provides client
- Offline-aware transport → REST adapter: dispatches requests
src/shared/services/api/transport/transport.ts - Offline-aware transport → Offline mutation queue: queues mutations
src/shared/services/api/transport/transport.ts - Offline sync engine → Offline mutation queue: replays queue
src/shared/services/api/offline/sync-engine.ts - Offline sync engine → Offline-aware transport: dispatches replay
src/shared/services/api/offline/sync-engine.ts - Zustand storage adapter → MMKV storage: reads and writes
src/shared/services/storage/zustand-mmkv-storage.ts - Navigation persistence → MMKV storage: persists state
src/navigation/persistence/navigation-persistence.ts