Skip to content

link-broker

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

link-broker

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
src
src
 
 
README.md
README.md
 
 
package.json
package.json
 
 
railway.toml
railway.toml
 
 

README.md

Lilo Link Broker

Minimal public service for Lilo Universal Links.

The broker owns one stable associated domain for the iOS app and forwards open instructions to the native app through Universal Links. Workspace servers can stay self-hosted and only generate broker URLs.

Routes

  • GET /health
  • GET /.well-known/apple-app-site-association
  • GET /apple-app-site-association
  • GET /open/<workspace-viewer-path>?w=<https-url>
  • GET /open?workspace=<https-url>&viewer=<workspace-viewer-path>

viewer must start with /workspace/ or /workspace-file/. /open/... is the compact form used for messaging buttons; /open?... remains supported for older verbose links.

Environment

LILO_IOS_UNIVERSAL_LINK_APP_IDS=<TEAM_ID>.<bundle.identifier>
PORT=8788

Railway

Create a separate Railway service with this directory as the service root, or use the link-broker/railway.toml config from the repo root.

The package declares packageManager: pnpm@10.5.2 so Railway should use pnpm even when this directory is deployed as a standalone service root.

The iOS entitlement should use the broker service domain:

applinks:<broker-domain>

Workspace servers that send messaging buttons should set:

LILO_LINK_BROKER_URL=https://<broker-domain>
LILO_PUBLIC_APP_URL=https://<workspace-domain>