cleanup before release

Author: abueide

.github/actions/setup-android-ci/action.yml

@@ -33,5 +33,5 @@ runs:
       working-directory: ${{ inputs.working-directory }}
       run: |
         # Select specific device to minimize SDK download and generate lock file
-        # This updates devices.lock.json with only the selected device(s)
+        # This updates devices.lock with only the selected device(s)
         bash ../../plugins/android/scripts/devices.sh select ${{ inputs.device }}

.github/workflows/pr-checks.yml

@@ -33,7 +33,6 @@ jobs:
         with:
           name: fast-test-reports
           path: |
-            test-results/
             reports/
           retention-days: 7
 

.github/workflows/publish-mcp.yml

@@ -47,7 +47,6 @@ jobs:
         with:
           name: test-reports
           path: |
-            test-results/
             reports/
           retention-days: 7
 

CLAUDE.md

@@ -509,7 +509,7 @@ scripts/
 
 **Critical**: Domain layer scripts cannot call each other. If two domain scripts need the same functionality, that functionality must be moved to the platform or lib layer. The user layer orchestrates multiple domain operations.
 
-See `plugins/android/scripts/LAYERS.md` for complete documentation.
+See `wiki/project/ARCHITECTURE.md` for complete documentation.
 
 ### Device Management Workflow
 

README.md

@@ -1,53 +1,138 @@
-# Segment Templates (mobile)
+# Devbox Plugins for Mobile Development
 
-Shared Devbox plugins and example projects for Android, iOS, and React Native.
+Reproducible, project-local development environments for Android, iOS, and React Native using [Devbox](https://www.jetify.com/devbox).
 
-## Devbox plugins
-- `devbox/plugins/android` — Android SDK + emulator management in a project-local virtenv.
-- `devbox/plugins/ios` — iOS toolchain + simulator management for macOS.
-- `devbox/plugins/react-native` — Composition of Android + iOS plugins.
+## Quick Start
+
+```bash
+# Add Android plugin to your project
+echo '{
+  "include": ["github:segment-integrations/devbox-plugins?dir=plugins/android"]
+}' > devbox.json
+
+# Enter development environment
+devbox shell
+
+# Start emulator and run app
+devbox run start-emu
+devbox run start-app
+```
+
+**New to devbox-plugins?** Check out the [Quick Start Guide](wiki/guides/quick-start.md) for detailed setup instructions.
+
+## Features
+
+- **Project-Local State** - All emulators, simulators, and caches stay in your project directory
+- **Reproducible Environments** - Lock files ensure consistent SDK versions across machines
+- **No Global Pollution** - Won't touch `~/.android`, `~/Library/Developer`, or other global state
+- **Parallel Execution** - Run multiple test suites simultaneously with `--pure` isolation
+- **Device-Driven Configuration** - Define devices as JSON, sync AVDs/simulators declaratively
+- **CI/CD Optimized** - Device filtering and platform skipping for fast CI builds
+
+## Plugins
+
+### Android Plugin
+
+Nix-managed Android SDK with AVD management.
+
+```json
+{
+  "include": ["github:segment-integrations/devbox-plugins?dir=plugins/android"]
+}
+```
+
+**Guides:** [Android Guide](wiki/guides/android-guide.md) | [Cheatsheet](wiki/guides/cheatsheets/android.md)
+**Reference:** [Android API](wiki/reference/android.md)
+
+### iOS Plugin
+
+Xcode toolchain integration with iOS Simulator management (macOS only).
+
+```json
+{
+  "include": ["github:segment-integrations/devbox-plugins?dir=plugins/ios"]
+}
+```
+
+**Guides:** [iOS Guide](wiki/guides/ios-guide.md) | [Cheatsheet](wiki/guides/cheatsheets/ios.md)
+**Reference:** [iOS API](wiki/reference/ios.md)
+
+### React Native Plugin
+
+Composition layer over Android and iOS with Metro bundler management.
+
+```json
+{
+  "include": ["github:segment-integrations/devbox-plugins?dir=plugins/react-native"]
+}
+```
+
+**Guides:** [React Native Guide](wiki/guides/react-native-guide.md) | [Cheatsheet](wiki/guides/cheatsheets/react-native.md)
+**Reference:** [React Native API](wiki/reference/react-native.md)
+
+## Documentation
+
+### For Users
+
+- **[Quick Start](wiki/guides/quick-start.md)** - Get started in 5 minutes
+- **[Device Management](wiki/guides/device-management.md)** - Managing emulators and simulators
+- **[Testing Guide](wiki/guides/testing.md)** - Testing strategies and best practices
+- **[Troubleshooting](wiki/guides/troubleshooting.md)** - Common issues and solutions
+- **[Cheatsheets](wiki/guides/cheatsheets/)** - One-page quick references
+
+### For Contributors
+
+- **[Contributing Guide](wiki/project/CONTRIBUTING.md)** - How to contribute
+- **[Architecture](wiki/project/ARCHITECTURE.md)** - Project structure and design
+- **[Testing](wiki/project/TESTING.md)** - Testing infrastructure
+- **[CI/CD](wiki/project/CI-CD.md)** - Continuous integration
+
+**Full documentation:** [Wiki Home](wiki/README.md)
 
 ## Examples
-- `devbox/examples/android` — Minimal Android app wired to the Android plugin.
-- `devbox/examples/ios` — Swift package initialized via the iOS plugin.
-- `devbox/examples/react-native` — React Native app wired to Android + iOS plugins.
-
-## Android plugin highlights
-- Device definitions live in `devbox.d/android/devices/*.json`.
-- Use `devbox run --pure android.sh devices list|create|update|delete` to manage devices.
-- Set `EVALUATE_DEVICES` environment variable in `plugin.json` to limit which device APIs are evaluated by the flake (empty means all).
-- `devbox run --pure start-emu [device]` boots an emulator.
-- `devbox run --pure start-app [device]` builds/installs/launches on the resolved emulator.
-See `devbox/plugins/android/REFERENCE.md` for the full Android reference.
-
-## iOS plugin highlights
-- Simulator definitions live in `devbox.d/ios/devices/*.json`.
-- `devbox run --pure start-sim [device]` boots a simulator.
-- `devbox run --pure stop-sim` stops it.
-See `devbox/plugins/ios/REFERENCE.md` for the full iOS reference.
-
-## React Native plugin highlights
-- Composes the Android + iOS plugins.
-- Android: `devbox run --pure start-emu`, `devbox run --pure start-app`, `devbox run --pure stop-emu`.
-- iOS: `devbox run --pure start-sim`, `devbox run --pure stop-sim`.
-See `devbox/plugins/react-native/REFERENCE.md` for the full React Native reference.
-
-## CI/CD
-
-Comprehensive GitHub Actions workflows are configured for testing:
-
-### Fast PR Checks (`pr-checks.yml`)
-Runs automatically on every PR with quick validation:
-- Plugin validation and unit tests
-- Quick smoke tests on default devices
-- ~15-30 minutes total
-
-### Full E2E Tests (`e2e-full.yml`)
-Manually triggered or scheduled weekly to test:
-- **Android**: API 21 (min) to API 36 (max)
-- **iOS**: iOS 15.4 (min) to iOS 26.2 (max)
-- **React Native**: Full cross-platform testing
-- Matrix execution for parallel testing
-- ~45-60 minutes per platform
-
-See [.github/workflows/README.md](.github/workflows/README.md) for detailed documentation.
+
+The repository includes example projects demonstrating plugin usage:
+
+- **[examples/android](examples/android/)** - Minimal Android app
+- **[examples/ios](examples/ios/)** - Swift package example
+- **[examples/react-native](examples/react-native/)** - React Native app with Android, iOS, and Web
+
+Each example includes device definitions, test suites, and build scripts.
+
+## Common Commands
+
+```bash
+# Android
+devbox run start-emu        # Start Android emulator
+devbox run start-app        # Build and launch app
+devbox run stop-emu         # Stop emulator
+
+# iOS
+devbox run start-sim        # Start iOS simulator
+devbox run start-ios        # Build and launch app
+devbox run stop-sim         # Stop simulator
+
+# Device management
+devbox run android.sh devices list
+devbox run ios.sh devices list
+
+# Testing
+devbox run test:fast        # Quick tests (~2-5 min)
+devbox run test:e2e         # Full E2E tests (~15-30 min)
+```
+
+## Requirements
+
+- **[Devbox](https://www.jetify.com/devbox)** - Install with `curl -fsSL https://get.jetify.com/devbox | bash`
+- **macOS** - Required for iOS plugin (Xcode required)
+- **Linux** - Supported for Android and React Native (Android only)
+
+## License
+
+MIT
+
+## Support
+
+- **Questions?** Check [Troubleshooting](wiki/guides/troubleshooting.md)
+- **Found a bug?** [Open an issue](https://github.com/segment-integrations/devbox-plugins/issues)
+- **Want to contribute?** Read the [Contributing Guide](wiki/project/CONTRIBUTING.md)

devbox.json

@@ -137,10 +137,17 @@
         "echo 'Running devbox-mcp plugin tests (interactive mode)...'",
         "TEST_TUI=true process-compose -f plugins/devbox-mcp/tests/test-suite.yaml"
       ],
+      "test:plugin:rn:lib": [
+        "bash plugins/tests/react-native/test-lib.sh"
+      ],
+      "test:plugin:rn": [
+        "devbox run test:plugin:rn:lib"
+      ],
       "test:plugin:unit": [
         "echo 'Running plugin unit tests...'",
         "devbox run test:plugin:android",
         "devbox run test:plugin:ios",
+        "devbox run test:plugin:rn",
         "devbox run test:plugin:devbox-mcp"
       ],
       "test:integration:android:device-mgmt": [

examples/android/devbox.d/android/devices/devices.lock

@@ -13,6 +13,6 @@
       "tag": "google_apis"
     }
   ],
-  "checksum": "2f3ab0e3cefd3e9909185c0717dc9d63038da1e81625eb6fce585e3af446bfef",
-  "generated_at": "2026-02-12T06:21:41Z"
+  "checksum": "8df4d3393b61fbbb08e45cf8762f95c521316938e514527916e4fce88a849d57",
+  "generated_at": "2026-02-18T16:48:27Z"
 }

examples/ios/devbox.d/ios/devices/devices.lock

@@ -9,6 +9,6 @@
       "runtime": "15.4"
     }
   ],
-  "checksum": "dd575d31a5adf2f471655389df301215f6ef7130ca284d433929b08b68e42890",
-  "generated_at": "2026-02-12T06:21:46Z"
+  "checksum": "4d5276f203d7ad62860bfc067f76194df53be449d4aa8a3b2d069855ec1f3232",
+  "generated_at": "2026-02-18T16:49:54Z"
 }

examples/react-native/devbox.d/android/devices/devices.lock

@@ -13,6 +13,6 @@
       "tag": "google_apis"
     }
   ],
-  "checksum": "2f3ab0e3cefd3e9909185c0717dc9d63038da1e81625eb6fce585e3af446bfef",
-  "generated_at": "2026-02-12T06:54:22Z"
+  "checksum": "8df4d3393b61fbbb08e45cf8762f95c521316938e514527916e4fce88a849d57",
+  "generated_at": "2026-02-18T16:50:49Z"
 }

examples/react-native/devbox.d/ios/devices/devices.lock

@@ -9,6 +9,6 @@
       "runtime": "15.4"
     }
   ],
-  "checksum": "dd575d31a5adf2f471655389df301215f6ef7130ca284d433929b08b68e42890",
-  "generated_at": "2026-02-12T06:55:59Z"
+  "checksum": "4d5276f203d7ad62860bfc067f76194df53be449d4aa8a3b2d069855ec1f3232",
+  "generated_at": "2026-02-18T16:50:50Z"
 }