pj/sanderling

0 Fork 0

mirror of https://github.com/priyanshujain/sanderling.git synced 2026-10-02 11:07:10 +00:00

Files

T

pj 007dcddd69 feat(ios): iOS e2e support — Kotlin Native SDK + simulator driver + test-ios (#38 )

* feat(ios): add simulator management package

* feat(testrun): add iOS platform path (simctl launch + direct TCP)

* feat(cli): add --ios-device flag and IosDevice option

* feat(sdk-ios): add Kotlin Native iOS SDK (TCP agent + POSIX socket + dispatch pauser)

* feat(folio-ios): wire SanderlingIos.start() in MainViewController

* feat(folio-ios): add test-ios justfile recipe

* fix(sdk-ios): remove unavailable C macros; manual byte swap + no-cast warnings

* fix(testrun): simctl-first launch order for iOS; Maestro init after SDK connects

2026-04-23 17:29:53 +07:00

composeApp

feat(ios): iOS e2e support — Kotlin Native SDK + simulator driver + test-ios (#38 )

2026-04-23 17:29:53 +07:00

gradle/wrapper

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

iosApp

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

kotlin-js-store/wasm

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

sanderling

feat(sdk-android): snapshot property delegate + feature-scoped files + screen fix (#34 )

2026-04-22 19:55:45 +07:00

.gitignore

refactor: rename project uatu -> sanderling (#24 )

2026-04-21 11:57:49 +07:00

build.gradle.kts

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

gradle.properties

test(folio): replace tautological properties with 4 domain invariants (#28 )

2026-04-21 17:53:55 +07:00

gradlew

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

gradlew.bat

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

justfile

feat(ios): iOS e2e support — Kotlin Native SDK + simulator driver + test-ios (#38 )

2026-04-23 17:29:53 +07:00

README.md

refactor: rename project uatu -> sanderling (#24 )

2026-04-21 11:57:49 +07:00

settings.gradle.kts

WIP: rename sample app to Folio (#20 )

2026-04-20 16:04:20 +07:00

README.md

Folio

A minimal Kotlin Multiplatform personal-ledger app: login with demo credentials, create accounts, add credits and debits. Shared UI across Android, iOS, and Web via Compose Multiplatform. Doubles as the example sanderling runs its property-based specs against.

Stack

Kotlin Multiplatform + Compose Multiplatform (shared UI)
kotlinx.serialization for file-backed persistence
kotlinx.coroutines for state flows
sanderling sdk-android for harness integration on Android

Prerequisites

just
JDK 17
Android SDK (auto-discovered under $ANDROID_HOME, ~/Library/Android/sdk, or the Homebrew cask)
Xcode 16+ and xcodegen (brew install xcodegen) for iOS

Android

just install      # build + install on a booted emulator / device
just uninstall
just clean

iOS

just ios                          # default device: iPhone 17 Pro
IOS_DEVICE="iPhone 15" just ios   # pick a different simulator

just ios regenerates iosApp/iosApp.xcodeproj from iosApp/project.yml, builds the KMP framework, links it into the SwiftUI host, installs, and launches.

Demo credentials

email:    [email protected]
password: ledger123

Run a sanderling test (Android)

just test

If no device is connected, sanderling boots the single AVD it finds. With multiple AVDs, pick one:

AVD=Pixel_7 just test

Persistent settings can live in .env alongside the justfile:

AVD=Pixel_7
DURATION=5m

Traces land in ./sanderling/runs/<timestamp>/.

How it connects to sanderling

composeApp/src/androidMain/.../FolioApplication.kt calls Sanderling.start(this) and registers snapshot extractors (logged_in, account_count, total_balance, route)
sanderling/spec.ts imports @sanderling/spec, reads those snapshots, asserts properties, and weights the actions the fuzzer picks from
just test invokes sanderling test against the installed APK