README.md

metadata

title: HiveTrace Leaderboard
emoji: 🛡️
colorFrom: green
colorTo: indigo
sdk: docker
app_port: 5173
pinned: true
short_description: HiveTrace leaderboard frontend
tags:
  - leaderboard
  - sveltekit
  - docker

HiveTrace Leaderboard frontend

Overview

HiveTrace Leaderboard is a SvelteKit frontend for browsing guardrail benchmark results from a private Hugging Face bucket.

The app uses:

• SvelteKit
• pnpm 11.9.0
• shadcn-svelte and shadcn-svelte-extras
• Tailwind CSS
• Paraglide JS for localization

Requirements

• Node.js 20.19.5 or newer
• pnpm 11.9.0

Setup

From the project root:

pnpm install

Create a local .env file from the example:

cp .env.example .env

Then configure a read token with access to the private Hugging Face bucket.

Required server-only environment variables:

HF_TOKEN=hf_...
HF_BUCKET_ID=...
HF_BUCKET_PREFIX=latest

Do not rename HF_TOKEN to PUBLIC_HF_TOKEN. The token is used only on the SvelteKit server. In production, pass it as a runtime secret, not as a Docker build argument.

Development

pnpm dev

Validation

Before pushing, format the code, run linting, run Svelte/TypeScript checks, and verify the production build.

Format:

pnpm format

Lint:

pnpm lint

Check Tailwind utility classes:

pnpm tailwind:check

Check SvelteKit, TypeScript, and Svelte components:

pnpm check

Build:

pnpm build