cnapp/README.md

cnapp

The mobile app for Chateau Neuf using React and Expo.

📚 Expo Documentation

Install

Use mise to install Node, Java and the Android SDK command-line tools.

mise trust
mise install
npm install
cp env-example .env.local

Development

This app uses native functionality that isn't supported by Expo Go, so you need a development build compiled from source. Follow Expo's local development setup guide for your platform, then build and run once (see below). After that, just start the dev server and open the app on your device or simulator:

npm run start

Android

mise install provides the Android SDK (the android CLI for managing the SDK, emulators and devices).

Next, install platform-tools (required for adb):

android sdk install platform-tools

Enable USB debugging or wireless debugging on a connected device, or start an emulator (android emulator start), then:

npm run android

iOS (requires macOS)

Install Xcode, then run on the Simulator or a connected device:

npm run ios

Scripts

• npm run start - Start Expo development server on port 19001
• npm run android - Run app in Android emulator
• npm run ios - Run app in iOS simulator (requires macOS)
• npm run web - Run app in web browser
• npm run lint - Check code with ESLint
• npm run format - Fix code formatting with ESLint
• npm run check-types - Run TypeScript type checking
• npm test - Run the test suite
• npm run test:watch - Run the test suite in watch mode

History

This is a fork of dusken-client with some history, code and binary blobs related to React Native functionality filtered out before commit 7f6b2c21.

TODO

• add functionality needed to pass new store requirements
  • privacy policy
  • delete my account
  • ???
• test in android emulator? (npm run android)
• test in ios emulator? (npm run ios, requires macOS)
• use Expo Application Services to build and submit app to stores
• replace redux (redux v5 + redux-thunk, hand-written actions and the deprecated createStore): nearly everything in the store is server state (user data) plus one auth token, so drop redux for TanStack Query for fetching/caching, with the token in React context + AsyncStorage — replaces src/reducers.ts, the fetch thunks in src/api.ts and the isFetching*/error flags
• replace moment (maintenance mode) with date-fns
• replace unmaintained UI packages:
  • react-native-simple-radio-button (last published in 2018, and untyped — it accounts for 5 of the errors npm run check-types reports); @expo/ui ships a native Picker in segmented/radio style, see the SDK 56 follow-ups below
• follow-ups from the Expo SDK 54 upgrade:
  • decide on Sentry: @sentry/react-native is installed but never initialized (see the commented-out init in index.ts), and its config plugin (now applied via app.json) warns about missing organization/project at every build — either finish the setup or drop the dependency
  • verify Android UI on a device/emulator: edge-to-edge is now always enabled and can no longer be disabled
  • try the React Compiler (enabled by default in new SDK 54 projects, opt-in for existing ones via "experiments": { "reactCompiler": true } in app.json)
  • add an iOS 26 liquid glass icon: a .icon file made with Apple's Icon Composer, referenced from ios.icon (old icon remains as fallback for older iOS); optionally play with expo-glass-effect
  • consider remote build caching (now stable) so npm run android/ios can download a cached build instead of compiling locally when the native fingerprint is unchanged
• follow-ups from the Expo SDK 56 upgrade:
  • replace the deprecated @expo/vector-icons with the scoped @react-native-vector-icons packages (npx @react-native-vector-icons/codemod) — only SimpleLineIcons in src/modules/events/EventList.tsx uses it, yet it ships ~3.5 MB of fonts into every export
  • try @expo/ui, production-ready as of SDK 56: real SwiftUI / Jetpack Compose components that could back the homegrown ones in src/components/ and finally retire react-native-simple-radio-button
  • simplify fetchWithTimeout in src/utils.ts: expo/fetch is now globalThis.fetch, so the wrapper collapses to fetch(url, { signal: AbortSignal.timeout(ms) }). Opt back out with EXPO_PUBLIC_USE_RN_FETCH=1 if it misbehaves
  • swap @react-native-async-storage/async-storage (used by redux-persist in src/reduxStore.ts) for expo-sqlite/localStorage, ideally folded into the redux replacement above
  • verify on iOS: the minimum target jumped to iOS 16.4 (from 15.1), dropping the iPhone 7, 6s and SE (1st gen). Building now requires Xcode 26.4 on macOS 13.4+
  • drop the @expo/config-plugins devDependency once @sentry/react-native fixes its config plugin: withSentryAndroidGradlePlugin.js imports @expo/config-plugins directly instead of expo/config-plugins, and SDK 56 no longer hoists it, so expo config crashes without the explicit dependency. Still broken in 8.20.0. Dropping Sentry outright would also remove it
  • Hermes V1 is now the default engine; turn it off with useHermesV1: false in expo-build-properties if it causes trouble
  • now on TypeScript 6: baseUrl is deprecated (gone in TS 7) and was removed from tsconfig.json, and TS 6 stopped auto-including @types/*, hence the explicit types field
• fix the 19 pre-existing npm run check-types errors (unchanged by the SDK upgrade)
• add Apple Pay for membership payments: either natively in the payment sheet (register the merchant ID merchant.no.neuf.chateau + Apple Pay certificate, set merchantIdentifier in the @stripe/stripe-react-native plugin config, pass applePay to initPaymentSheet, new iOS build), or for free by moving payment to a Stripe-hosted Checkout page in the browser (needs a backend Checkout Session endpoint and a return deep link)
• add Google Pay for membership payments: either natively in the payment sheet (enableGooglePay: true in the plugin config, pass googlePay to initPaymentSheet, request production access in the Google Pay & Wallet Console, new Android build), or for free via the same Stripe-hosted Checkout page as for Apple Pay