Links

Contact preference center, tracked link redirects, and open-tracking pixel proxy for outbound email.

Run bun setup once from the monorepo root before starting individual apps. Preferences need contacts and mail running (bun dev or bun backend:dev).

Overview

Property	Value
Directory	`apps/frontend/links`
Port	`3005`
Preferences	https://local.reloop.sh/preferences
Redirect	https://local.reloop.sh/redirect
Open tracking	https://local.reloop.sh/api/mail/v1/track/open
Stack	Next.js · React 19 · Tailwind CSS

Quick start

From the monorepo root (after bun setup):

bun fe:links:dev

Or start every frontend together:

bun frontend:dev

Turbopack serves the app on port 3005. Prefer the local.reloop.sh URLs above when Caddy is running.

Use https://local.reloop.sh/..., not localhost:3005, so redirects and cookies match production-style hosts.

Environment

Committed local defaults live in apps/frontend/links/.env (and .env.dev). Fresh clones already have them; bun env:setup / bun setup recreate or merge missing keys.

NEXT_PUBLIC_URL=https://local.reloop.sh
# Must match TRACKING_SECRET in the mail backend and REDIRECT_SECRET in auth/email backends
REDIRECT_SECRET=reloop_tracking_secret_default_123

# Server-side contacts API (preferences page)
INTERNAL_API_URL=http://localhost:8014/api/contacts

# Server-side mail API (open-tracking pixel proxy)
INTERNAL_MAIL_API_URL=http://localhost:8015/api/mail

# Rybbit analytics (optional)
NEXT_PUBLIC_RYBBIT_HOST=https://app.rybbit.io
NEXT_PUBLIC_RYBBIT_SITE_ID=reloop-web

Preferences call contacts via INTERNAL_API_URL. Open-tracking proxies to mail via INTERNAL_MAIL_API_URL (or NEXT_PUBLIC_URL as a fallback).

Variable	Required	Default
`NEXT_PUBLIC_URL`	No	`https://link.reloop.sh` — base URL for redirect and preference links
`REDIRECT_SECRET`	No	Shared secret with mail / auth / email backends
`INTERNAL_API_URL`	No	`http://localhost:8014/api/contacts`
`INTERNAL_MAIL_API_URL`	No	Falls back to `{NEXT_PUBLIC_URL}/api/mail`
`NEXT_PUBLIC_RYBBIT_HOST`	No	Rybbit analytics host
`NEXT_PUBLIC_RYBBIT_SITE_ID`	No	Rybbit site identifier

Routes

Route	Purpose
`/preferences/[token]`	Manage subscription topics and unsubscribe
`/redirect/[token]`	Track clicks and redirect to destination URL
`/api/mail/v1/track/open/[token]`	Proxy open-tracking pixels to the mail service

Architecture

Layer	Detail
Mail	Injects `/redirect/[token]` click links and open pixels in outbound HTML
Contacts	Powers preference page data
Open-tracking proxy	Custom tracking domains CNAME here; pixels proxy to mail when `/api/mail` is not on the tracking host
Caddy	Routes `/preferences` and `/redirect` to port `3005`

Commands

Command	Description
`bun fe:links:dev`	Start dev server with Turbopack
`bun run --filter=fe-links build`	Compile production bundle
`bun run --filter=fe-links start`	Run production build
`bun run --filter=fe-links lint`	Run ESLint checks

Setup

One-command local bootstrap

Port reference

Gateway routes and ports

Contacts

Preferences data API

Mail

Tracking links and open pixels

Overview

Quick start

Environment

Routes

Architecture

Commands

Next

Setup

Port reference

Contacts

Mail