Full-screen text for any screen. Type a message in the editor and it fills the screen, as big as it fits. The whole display lives in the URL, so there's no backend, no accounts and nothing stored on a server.

• Editor /editor: write the message and set colors, fonts, slides, countdowns, animations and QR codes with a live preview. Copy URL copies the display link, and the QR button shows it as a code, so you can open it on a phone, tablet or TV by scanning.
• Viewer /#…: the display itself, fullscreen, with no controls. This is the link you share, bookmark or open on the screen.
• Docs /docs: the reference, built from docs/REFERENCE.md. All of the URL parameters are documented, so generating links is easy.

Features:

• Text fits itself to any screen size and orientation
• A small Markdown subset: bold, italic, headings, line breaks
• Slides, split with ||
• Countdowns to a date and time (until) or for a length of time (timer)
• Animations, bundled open-source fonts and aspect-ratio framing
• QR codes drawn in the browser: links, Wi-Fi, calls, texts, email, locations
• Images, and keeping the screen awake while a display is open

The display lives in the URL fragment (after the #), which browsers never send to the server.

The build is a folder of static files, so any static host works if it serves index.html for /, editor.html for /editor, docs.html for /docs, and 404.html with status 404 for any other path. If your host sends a Content-Security-Policy, copy the script-src from the Caddyfile: index.html has one inline script, allowed by its hash. The supported way to run it is the Docker image.

The image is the official caddy image serving the build from /usr/share/caddy, with a Caddyfile that listens on :80, sets the security headers and serves 404.html for unknown paths.

git clone https://github.com/SpeakingOfBrad/BIGWORDS.PAGE.git
cd BIGWORDS.PAGE
docker compose up -d --build

compose.yaml publishes no ports (port 80 is listed but commented out). Attach the service to your reverse proxy's network and let the proxy handle TLS. The proxy should also send Strict-Transport-Security.

The container is locked down by default. The image runs Caddy as a non-root user (UID 65532) with its admin API off, and compose.yaml adds a read-only filesystem, drops every capability except binding port 80, blocks privilege escalation and caps memory and CPU. If you run the image some other way, such as plain docker run or Kubernetes, it still runs as non-root; keep NET_BIND_SERVICE if you drop capabilities, since the Caddy binary needs it to start, and give /data a writable tmpfs if you make the filesystem read-only.

All optional. Set them as environment variables for npm run build, or as build args in compose.yaml (build.args) or docker build --build-arg.

Requires Node 22.22.2+, 24.15+ or 26+. CI and the Docker build use the LTS release in .node-version, currently 24.

npm install
npm run dev        # dev server
npm test           # unit tests (Vitest)
npm run typecheck
npm run build      # static output in dist/
npm run preview    # serve dist/ on :4173
npm run smoke      # browser smoke test against the preview server (Playwright)
npm run clipcheck  # checks that no glyph ink is clipped at the text area edges

GitHub Actions (.github/workflows/ci.yml) runs the unit tests, build and smoke test on every push to main and every pull request. Clipcheck runs too, but its result doesn't fail the build.

The social card public/og.png, the app icons (public/apple-touch-icon.png, public/icon-*.png) and the install screenshots (public/screenshots/) are rendered by npm run og (with npm run preview running) and committed. Re-run it after changing the fonts, the favicon or the editor's look. The editor screenshots show SITE_URL in the URL field, or example.com without it.

Project layout:

MIT. Bundled fonts and libraries keep their own licenses; see THIRD_PARTY_NOTICES.md.