Dashboard UI

Trove includes a Forge Dashboard contributor that provides a web UI for managing all aspects of object storage. The dashboard gives operators visibility into buckets, objects, multipart uploads, content-addressable storage, and quota usage without writing code or using the REST API.

Enabling the Dashboard

The dashboard is automatically registered when the Trove extension is used alongside the Forge Dashboard extension. No additional configuration is required:

import (
    "github.com/xraph/forge"
    dashboardext "github.com/xraph/forge/extensions/dashboard"
    troveext "github.com/xraph/trove/extension"
)

app := forge.New(
    forge.WithExtensions(
        dashboardext.New(),
        troveext.New(),
    ),
)

When both extensions are present, Trove registers its dashboard pages into the Forge dashboard automatically via DI auto-discovery.

Dashboard Pages

Overview

The landing page displays storage statistics at a glance: total objects, total bytes stored, active multipart uploads, CAS entries, and current quota usage across all tenants.

Buckets

List all buckets with object counts and total size. Create new buckets, view bucket details, and delete empty buckets. Each bucket links to its object listing.

Objects

Browse objects within a bucket. Upload new objects, download existing ones, view metadata (content type, size, checksums, tags), and delete objects. Supports prefix-based filtering for navigating large buckets.

Uploads

Monitor active multipart uploads with progress indicators. View individual part status, elapsed time, and total size. Abort stale or abandoned uploads to reclaim storage.

CAS

View the content-addressable storage index with reference counts, content hashes, and total deduplicated bytes. Identify pinned entries that are exempt from garbage collection. Trigger manual GC runs to reclaim unreferenced content blocks.

Quotas

View per-tenant storage quotas with usage-versus-limit breakdowns. See which tenants are approaching their limits and manage quota assignments.

Settings

Inspect the active Trove configuration: driver DSN, base path, CAS algorithm, Grove database, and the current middleware pipeline. Useful for verifying runtime configuration in deployed environments.

File Browser

A hierarchical file browser for each bucket that supports common file operations: upload, download, copy, paste, rename, and delete. Navigate nested key prefixes as if they were directories, making it easy to manage objects with path-like keys.

Routes

Dashboard routes are registered under the Forge dashboard base path. By default, Trove's dashboard pages are available at:

/dashboard/trove/

The exact prefix depends on the Forge Dashboard extension's own base_path configuration. All Trove dashboard routes are nested under the dashboard's route group, inheriting its authentication and middleware.

HTMX Integration

The dashboard uses HTMX for interactive updates without full page reloads. Actions like creating a bucket, uploading an object, or aborting an upload are performed via HTMX-driven requests that swap content in place. This keeps the interface responsive while maintaining server-rendered HTML as the source of truth.

Table listings support HTMX-powered pagination and inline search, so operators can navigate large datasets without leaving the page.