raclette Workbench

The raclette Workbench is a built-in interface that ships with every raclette installation. It serves as the central control panel for managing and configuring your project — without the need to write code.

The workbench is primarily designed for admin users, not developers. It provides a visual interface for defining the structure, views, and interactions of the application.

By default, the raclette Workbench is accessible at: http://localhost:8083/

TIP

While the Workbench can in theory be used with touch devices, we do recommend using a device with mouse/keyboard within the workbench

First-Time Setup

When opening the raclette Workbench for the first time, you’ll be guided through a setup wizard to create your first project. During this process, you’ll:

• Choose a name for your application
• Register an initial admin user
• Optionally import default compositions and interaction links from your app’s config/ folder (when present)
• Finalize the project setup

Apps can ship default layout seeds at:

<app>/
  config/
    compositions.js
    interactionLinks.js

Use the same shape as the workbench static config (stable _ids, no Mongo metadata). The workbench loads these via the backend (not the frontend bundle) and can import them from the setup wizard or later from Project edit.

Show Screenshots

Step 1

Step 2

Step 3

Once the project is initialized, you can begin configuring it right away.

What You Can Do

The raclette Workbench allows you to:

• Create and manage Compositions
• Define Interaction Links
• Inspect the shared Valkey cache with the Cache List widget (admin only)
• Configure application-level settings and behavior

This tool empowers non-developer administrators to customize the application for their end users through an intuitive UI — all without editing the underlying codebase.