a simple pds frontend for listing accounts and generating invite codes
Files
README.md

tea party #

a PDS account directory with one-use invite codes.

setup #

requires Node.js 24.22.1 or a newer patched 24.x release, plus Caddy or Podman.

npm ci
npm test
npm run check
npm run build

npm run dev previews the frontend layout. for working invites, run the issuer and serve the built files with the supplied Caddy configuration.

deployment #

follow deploy/README.md for the container setup and proxy changes. the three example environment files separate issuer, directory and refill configuration. only the offline refill job gets the PDS admin password.

create a Turnstile widget for your public hostname and configure its site key and secret in the issuer environment. Cloudflare proxying is not required.

by default, each IP and browser session gets three invites per rolling day; an IPv6 /64 gets six. the site-wide ceiling is ten per hour and thirty per day. the pool holds at most ten unused codes and the refill job creates at most thirty per day. adjust the limits in the example environment files as needed.