|
| 1 | +# Starter Apps Tracking |
| 2 | + |
| 3 | +External example repositories that consume the RunAnywhere SDKs. |
| 4 | +Cloned into `external_examples/` locally (gitignored). Used by |
| 5 | +`release.yml`'s consumer-validation jobs to verify every release |
| 6 | +actually installs and builds in a downstream app. |
| 7 | + |
| 8 | +**Unified version going forward: all SDKs will publish at the same |
| 9 | +semver (e.g., `v0.19.8`, `v0.20.0`). Starter apps can pin to any tag.** |
| 10 | + |
| 11 | +| SDK | Repo | HEAD commit | HEAD date | Currently pins | |
| 12 | +|---|---|---|---|---| |
| 13 | +| Swift | `RunanywhereAI/swift-starter-example` | `fe98b78` | 2026-03-19 | ? | |
| 14 | +| Kotlin | `RunanywhereAI/kotlin-starter-example` | `56423ad` | 2026-02-16 | ? | |
| 15 | +| Web | `RunanywhereAI/web-starter-app` | `bc6347a` | 2026-02-27 | @runanywhere/web@0.1.0-beta.10 | |
| 16 | +| Flutter | `RunanywhereAI/flutter-starter-example` | `6587079` | 2026-02-14 | 0.16.0 | |
| 17 | +| React Native | `RunanywhereAI/react-native-starter-app` | `8068d0b` | 2026-02-14 | @runanywhere/core@^0.18.1 | |
| 18 | + |
| 19 | +## How to update these locally |
| 20 | + |
| 21 | +```bash |
| 22 | +for repo in swift-starter-example kotlin-starter-example web-starter-app flutter-starter-example react-native-starter-app; do |
| 23 | + if [ -d "external_examples/$repo" ]; then |
| 24 | + (cd "external_examples/$repo" && git pull --ff-only) |
| 25 | + else |
| 26 | + gh repo clone "RunanywhereAI/$repo" "external_examples/$repo" |
| 27 | + fi |
| 28 | +done |
| 29 | +``` |
| 30 | + |
| 31 | +## After cutting a release |
| 32 | + |
| 33 | +1. `release.yml` builds artifacts and creates a draft GitHub Release. |
| 34 | +2. `release.yml`'s consumer-validation jobs clone each starter repo and try |
| 35 | + to build it against the freshly-produced artifacts (`continue-on-error: true`). |
| 36 | +3. If a starter fails to build, it's a signal the public API broke — either |
| 37 | + update the starter (post-release) or patch the SDK (post-release). |
| 38 | +4. Publish the draft release once starters are green. |
0 commit comments