docs: restore demo sample sections

Author: transphorm

.cursor/rules/mobile-sdk-migration.mdc

@@ -113,13 +113,27 @@ contextUsageNote: If this file is used to add in-context notes, include a single
 - Test signature verification
 - Test storage adapter integration
 
-### 9. SDK Integration into App
+### 9. Sample Applications
+**Target Location**: `packages/mobile-sdk-alpha/samples/`
+**Testing Strategy**:
+- Create React Native demo with MRZ → proof flow
+- Create web demo with browser-based MRZ input
+- Test iOS `OpenPassport` URL scheme
+
+### 10. SDK Integration into App
 **Migration Strategy**:
 - Replace existing modules with SDK imports
 - Update import paths throughout app
 - Validate all existing functionality works
 - Ensure no regression in app behavior
 
+### 11. In-SDK Lightweight Demo
+**Target Location**: `packages/mobile-sdk-alpha/demo/`
+**Testing Strategy**:
+- Embedded React Native demo using MRZ → proof flow
+- Test theming hooks integration
+- Validate build and run instructions
+
 ## Testing Best Practices
 
 ### Test Data Management

packages/mobile-sdk-alpha/docs/MIGRATION_CHECKLIST.md

@@ -53,8 +53,18 @@
 - Enforce CDN allowlist and Content-Length checks.
 - Stream hashing to avoid buffering large files.
 
-## 9. Integrate SDK into `/app`
+## 9. Sample applications
+
+- React Native and web demos showcasing core flows.
+- iOS `OpenPassport` URL scheme.
+
+## 10. Integrate SDK into `/app`
 
 - Consume `@selfxyz/mobile-sdk-alpha` inside the `app` workspace.
 - Replace MRZ modules with SDK adapters and wire processing helpers.
 - Validate builds and unit tests.
+
+## 11. In-SDK lightweight demo
+
+- Embedded React Native demo inside the SDK with theming hooks.
+- Provide build and run instructions.

packages/mobile-sdk-alpha/docs/MIGRATION_PROMPTS.md

@@ -205,7 +205,37 @@ yarn build
 
 </details>
 
-## 9. Integrate SDK into `/app`
+## 9. Sample applications
+
+<details>
+<summary><strong>Add React Native sample</strong></summary>
+
+1. Under `samples/react-native/`, scaffold a bare-bones app using Expo or React Native CLI.
+2. Demonstrate MRZ scanning and registration flow using SDK APIs.
+3. Include instructions in a `README.md`.
+
+</details>
+
+<details>
+<summary><strong>Add web sample</strong></summary>
+
+1. Under `samples/web/`, set up a Vite/React project showing browser-based MRZ input and proof generation.
+2. Document setup and build steps.
+
+</details>
+
+<details>
+<summary><strong>Configure OpenPassport scheme</strong></summary>
+
+1. In the React Native sample's iOS project, add URL type `OpenPassport` to `Info.plist`.
+2. Document Android intent filters (AndroidManifest.xml). Ensure scheme uniqueness and validate redirect origins to prevent hijacking.
+3. Choose a scheme unique to your app (e.g., using reverse-domain or app-identifier prefix).
+4. Detect and handle collisions (fallback checks, verify caller package/signature).
+5. Verify redirect domains and consider app-claimed links/Android App Links and iOS Universal Links for stronger security.
+
+</details>
+
+## 10. Integrate SDK into `/app`
 
 <details>
 <summary><strong>Integrate SDK in /app</strong></summary>
@@ -216,3 +246,16 @@ yarn build
 4. Validate builds and unit tests in the `app` workspace.
 
 </details>
+
+## 11. In-SDK lightweight demo
+
+<details>
+<summary><strong>Create embedded demo app</strong></summary>
+
+1. Scaffold `demo/` under the SDK as a minimal React Native project.
+2. Use SDK APIs for MRZ → proof flow.
+3. Expose simple theming configuration.
+4. Add `demo/README.md` with build/run instructions.
+5. Add publishing guardrails: exclude `demo/` from npm and add a CI step to verify the published tarball contents.
+
+</details>