Skip to content

PWA + Web Share Target (Android)

Install Lattice as a home screen app on Android. Share anything — a webpage, a note, a YouTube link — directly to Lattice from any app's Share Sheet.

Privacy: Your captures go directly to your own daemon. Nothing touches Telegram or any third-party service.

Requirement: HTTPS access to your Lattice daemon from your phone. Any tunnel or VPN works — Tailscale is a common choice. How you get HTTPS is not Lattice's job; this guide assumes you already have it.

Step 1 — Set LATTICE_PUBLIC_URL

Add your public HTTPS URL to the daemon plist:

<key>LATTICE_PUBLIC_URL</key>
<string>https://your-daemon-url</string>

Reload the daemon:

launchctl unload ~/Library/LaunchAgents/dev.lattice.daemon.plist
launchctl load  ~/Library/LaunchAgents/dev.lattice.daemon.plist

Verify it's live:

curl -s https://your-daemon-url/health | python3 -m json.tool
# {"ok": true, ..., "public_url": "https://your-daemon-url"}

uv run lc status
# Remote: https://your-daemon-url

Step 2 — Install the PWA on Android

  1. On your Android phone, open Chrome
  2. Navigate to https://your-daemon-url
  3. Chrome shows a banner: "Add Lattice to Home screen" — tap it
    If no banner: tap ⋮ → Add to Home screen → Install
  4. The Lattice icon appears on your home screen

Open it — it launches in standalone mode (no Chrome address bar). You now have a native-feeling Lattice app on Android.

Step 3 — Capture via Share Sheet

  1. In any Android app, find text you want to save (a webpage, a message, a note)
  2. Tap Share → select Lattice from the share sheet
  3. Lattice opens with a capture panel showing the shared content
  4. Tap Capture → saved to your memory

The panel also offers Ask instead — prefills the query input so you can ask a question about the shared content rather than capturing it.

What gets shared

Source app What lands in Lattice
Chrome Page title + URL
YouTube Video title + URL
Twitter / X Tweet text
WhatsApp Message text
Any app with Share Whatever text the app exposes

Troubleshooting

Lattice doesn't appear in the Share Sheet: PWA must be installed first (Step 2). The share target is registered at install time.

Share Sheet shows Lattice but nothing happens: Your daemon URL may be unreachable from your phone. Check VPN/Tailscale is connected and https://your-daemon-url/health responds.

Chrome won't show "Add to Home screen": Requires HTTPS with a valid certificate. Plain http:// or self-signed certs won't trigger PWA install in Chrome.

Share panel shows but Capture fails: Daemon is unreachable. Check https://your-daemon-url/health from your phone browser.