Introduction
Email Link Host is a free, static (or tiny Go/Docker) host for:
- Firebase Auth email-link continue URLs on a branded domain
- Android App Links (
/.well-known/assetlinks.json) - iOS Universal Links (
/.well-known/apple-app-site-association) - Optional Google Play / App Store buttons on a themed landing page
It pairs with App Universal Links Helper (source) — a browser tool that generates association files and AndroidManifest snippets you can paste into this host.
Quick paths
| Goal | Start here |
|---|---|
| Configure brand / theme / store URLs / app IDs | Configuration |
| Deploy (per platform: which files to edit) | Hosting overview |
| Live Firebase Hosting demo | fir-email-link-host.web.app |
| Deploy with Docker | Docker hosting |
| Generate association files | Universal Links Helper |
| Let an AI agent host for you | Agent skills |
Stack
- Next.js static export for CDN hosts (Bun for install/build)
- Pure Go binary for Docker (
scratchimage, multi-arch on Docker Hub as$DOCKERHUB_USERNAME/email-link-host) - Docusaurus docs (this site), always with Bun — not npm/yarn
Always use Bun
bun install
bun run dev
bun run build
In the docs site:
cd docs-website
bun install
bun start