ticker-admin

The admin interface for the Ticker project. Editors use it to manage tickers, post messages, connect integrations and administer users.

It is a static single-page application and holds no data of its own; everything lives in the ticker API.

Documentation

https://systemli.github.io/ticker/

Installation, configuration, deployment and troubleshooting for the whole stack are documented centrally:

• Installation — running the full stack with Docker
• Configuration
• Troubleshooting

The published image is systemli/ticker-admin.

Development

Requirements: Node 24 (see .nvmrc) and a running ticker API.

nvm use
npm install
npm run dev        # http://localhost:3000

Point it at your API with a .env file. The URL must include the /v1 suffix:

TICKER_API_URL=http://localhost:8080/v1

Without this the application falls back to a relative /api, which only works when something is proxying that path — as the Docker image expects. Restart the dev server after changing .env.

Commands

npm test           # vitest, watch mode
npm run coverage
npm run lint
npm run tsc        # type check
npm run build
npm run preview

See AGENTS.md for project structure, conventions and testing patterns, and the development guide for working across the three repositories.

Localization

Strings live in the locales folder. To add a language, update:

• i18n.ts to register it
• UserListItem.tsx for dayjs relative times

Use the t('stringKey') notation for new strings and update all locales.

Licence

GPL-3.0. See LICENSE.