Skip to content
Trakli Docs

Running the web UI

The web UI is a Nuxt 3 application. It is the browser dashboard and it talks to the webservice over the REST API. Run the backend first, then point the UI at it.

Get the code and dependencies

Section titled “Get the code and dependencies”
Terminal window
git clone https://github.com/trakli/trakli.git
cd trakli/ui
npm install

Point it at your backend

Section titled “Point it at your backend”

In development, the Nuxt dev server proxies /api to the backend, so the UI and API appear on the same origin. In production, set the API base URL with an environment variable:

Terminal window
NUXT_PUBLIC_API_BASE_URL=https://api.your-domain.example

Run the dev server

Section titled “Run the dev server”
Terminal window
npm run dev

The dashboard is now available locally. Register or sign in with an account on your backend, and your data flows through the same API documented in the API reference.

Build for production

Section titled “Build for production”
Terminal window
npm run build

Serve the build output behind your web server or platform of choice, with NUXT_PUBLIC_API_BASE_URL set to your backend.

Run the tests

Section titled “Run the tests”
Terminal window
npm run test

How it fits together

Section titled “How it fits together”

The UI holds no canonical data. It reads and writes everything through the backend’s API, which means the backend’s auth and the agent’s guardrails apply no matter which client you use: web, mobile, or your own integration.