Link Shortener for AT Protocol#

Server-side link shortener powered by your Linkat board. No database — links are fetched from AT Protocol.

Independent project; see the trademark notice.

Also available on Tangled

How it works#

1. You maintain links in Linkat (stored in blue.linkat.board collection)
2. Service fetches them on-demand from your PDS via Slingshot
3. URLs get a deterministic 6-char base62 hash (e.g., /a3k9zx)
4. Visiting that short link returns a 301 redirect

Quick start#

git clone git@github.com:ewanc26/atproto-shortlink
cd atproto-shortlink
npm install

Copy .env.example to .env and add your AT Protocol DID:

ATPROTO_DID=did:plc:your-did-here

Find your DID at pdsls.dev.

If you don't have a Linkat board yet, create one at linkat.blue.

Test config#

npm run test:config

Checks that .env exists, DID is valid, PDS is reachable, and your Linkat board is accessible.

Run#

npm run dev

Endpoints#

Deploy#

npm run build
npm run preview

Uses @sveltejs/adapter-auto — works with Vercel, Netlify, Cloudflare Pages, or Node.

Set ATPROTO_DID in your deployment platform's env vars.

Config ref#

Development#

npm run dev     # dev server
npm run check   # type check
npm run format  # format
npm run lint    # lint

Licence#

AGPLv3 — see LICENCE