Command

PePersonal JEJust Electrolyte RTRelease Timer TtTacTile CSClearSource AtAthletic

TacTile›Launch TacTile›Web›Web → app handoff·12 in this wave

Approve: Web → app handoffTo do · blocker Register the deep-link scheme on iOSTo do Set up iOS Universal Links for the handoff pathsTo do Set up Android App Links for the handoff pathsTo do Build the deep-link routing layerTo do Design the handoff experienceTo do Build the desktop handoffTo do Build the mobile-web handoffTo do Handle the not-installed case gracefullyTo do Build the return path after programmingTo do Make the capability boundary honest in the web UITo do Verify the handoff end to endTo do

Wave

Web → app handoff

Web can't write NFC tags, so programming a physical tag has to hand off cleanly to the native app. Deep-link infrastructure may not exist at all — verify before building on it.

TacTile › Launch TacTile › Web › Web → app handoff

0/12 done12 open1 open blocker

Selected taskclear

Set up iOS Universal Links for the handoff paths

To doOwner · Vivt_2d436d23

Viv — Fix the Release-build Universal Links gap and extend apple-app-site-association to cover handoff paths. Done when: TacTileConnect.Release.entitlements includes com.apple.developer.associated-domains (applinks:tactile.to), and the AASA paths array covers the new handoff route(s) alongside existing /auth/* entries, verified on a Release-signed build. File: apps/ios/TacTileConnect/TacTileConnect.Release.entitlements, apps/web/public/.well-known/apple-app-site-association.

Unlocks 2Build the deep-link routing layer Approve: Web → app handoff

Show the prompt

You are Viv, the agent for the TacTile lane of Command.

Open the lane and work there:

```bash
cd ~/Command/tactile && claude
```

Read that lane's CLAUDE.md and lane.json before you touch anything — they
carry your identity, your scope, and the hazards specific to this lane.
Read state from the hub (https://internal.tactile.to) or ask. Never guess at it.

## The task

**Set up iOS Universal Links for the handoff paths** · to do

Viv — Fix the Release-build Universal Links gap and extend apple-app-site-association to cover handoff paths. Done when: TacTileConnect.Release.entitlements includes com.apple.developer.associated-domains (applinks:tactile.to), and the AASA paths array covers the new handoff route(s) alongside existing /auth/* entries, verified on a Release-signed build. File: apps/ios/TacTileConnect/TacTileConnect.Release.entitlements, apps/web/public/.well-known/apple-app-site-association.

Where it sits: TacTile › Launch TacTile › Web › Web → app handoff

## Unlocks 2

- Build the deep-link routing layer
- Approve: Web → app handoff

## The brief on file

Audit finding, confirmed in project.pbxproj: the iOS target's Release build configuration (line ~3725) points CODE_SIGN_ENTITLEMENTS at TacTileConnect/TacTileConnect.Release.entitlements — and that file has NO com.apple.developer.associated-domains key. The Debug entitlements file (TacTileConnect.entitlements) DOES have it (applinks:tactile.to). So Universal Links currently work in Debug builds only and are silently broken in every Release/TestFlight/App Store build. Separately, apps/web/public/.well-known/apple-app-site-association already exists and is correctly matched to the current bundle id (appID "MB9S8F68KG.tac.tile" — confirmed against PRODUCT_BUNDLE_IDENTIFIER = tac.tile in project.pbxproj), but its "paths" array is scoped only to ["/auth/*", "/auth/callback", "/auth/callback/*"] for the Supabase OAuth redirect. Fix both: (1) add com.apple.developer.associated-domains (applinks:tactile.to) to TacTileConnect.Release.entitlements so Release builds actually get Universal Links, (2) extend the AASA paths array with the new web→app handoff route(s) decided in the handoff-experience design task (e.g. /handoff/* or /nfc/program/*). Verify with Apple's AASA validator (https://search.developer.apple.com/appsearch-validation-tool/) and by tapping a real link on a Release-signed TestFlight build.

## How to work this

- Do the work, don't just plan it. If the fix is obvious and safe, make it.
- Surface anything needing Matthew's sign-off instead of deciding it yourself.
- Short replies. Lead with the answer, then stop.
- Finish by saying what changed, what you verified, and what you'd do next.

To doIn progressDoneBlockedPick a wave on the left · tap a task to expand it

Lanes

Web → app handoff

Set up iOS Universal Links for the handoff paths