Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
81 lines (51 loc) · 1.91 KB

CONTRIBUTING.md

File metadata and controls

81 lines (51 loc) · 1.91 KB

Repository development setup

Example app config (env-driven)

The example app uses apps/example/app.config.ts so local developer values do not need to be committed.

Create local env values from the template:

cp apps/example/.env.example apps/example/.env

Supported variables:

  • RNDA_APPLE_TEAM_ID
  • RNDA_APP_GROUP
  • RNDA_IOS_BUNDLE_ID
  • RNDA_ANDROID_PACKAGE

If these variables are missing, app.config.ts falls back to stable defaults for this repository.

Example app follows CNG

The example app no longer tracks apps/example/ios and apps/example/android. The example target folder apps/example/targets is also generated during prebuild and should not be committed.

Regenerate native folders when needed:

cd apps/example
bun run prebuild
# or
bun run ios
bun run android

Swift test ownership

Swift test sources are package-owned and live in:

  • packages/react-native-device-activity/ios/Tests

The iOS test runner lives in:

  • packages/react-native-device-activity/ios/TestHarness

SwiftLint setup

The repository runs SwiftLint from the iOS test harness CocoaPods installation:

  • packages/react-native-device-activity/ios/TestHarness/Pods/SwiftLint/swiftlint

Run this once after cloning (and again if Pod dependencies are cleaned):

cd packages/react-native-device-activity/ios/TestHarness
pod install

Then run repository checks from the root:

bun run pre-push

Formatting setup

The formatting scripts intentionally call node ./node_modules/prettier/bin/prettier.cjs to avoid PATH/bin shadowing from transitive tooling (see expo/expo#42994).

Plugin testing

In addition to app/prebuild validation, config plugin regression tests are defined under:

  • packages/react-native-device-activity/plugin/__tests__

Run them with:

cd packages/react-native-device-activity
bun run test:plugin