Throttle List

The Throttle List screen (/throttles) gives you a bird's-eye view of every active throttle on your layout. It is designed for operators who need to monitor and control multiple trains at the same time.

Throttle List grid view

Grid Layout

Active throttles are displayed as ThrottleTile cards arranged in a responsive grid:

On mobile screens, each tile takes the full width (one column).
On wider screens (600px+), tiles arrange into a two-column grid, each tile taking half the width.

Tiles are rendered at the bottom of the viewport and fill upward, so you see your most recently added throttles aligned toward the bottom of the screen -- a layout choice that keeps the Add Throttle card easily reachable on touch devices.

Throttle Tiles

Each tile is a compact version of the full throttle control, rendered as a rounded card with a colored accent bar. Tiles follow your chosen throttle type (Buttons, Slider, or Dashboard) from Settings, and all three share the same two-row layout:

Identity row -- the locomotive's number plate (its DCC address on a colored plate) on the left, the locomotive name in the middle, and the current speed display on the right. The number plate also serves as the drag handle (shown with a grab cursor) and carries a badge with the unit count when the loco is part of a consist.
Controls row -- an eject button to park (release) the locomotive, the speed controls (horizontal −5 / −1 / +1 / +5 buttons for the Buttons type, or a speed slider with an R/F reverser lever for the Slider and Dashboard types), and a dedicated stop button.

Single throttle tile

Drag to Reorder

Tiles can be reordered by dragging the number plate (the drag handle on the left of each tile), with a smooth drag-and-drop animation.

Your custom tile order is remembered across page reloads and browser sessions. The ordering logic works as follows:

Throttles with a saved position are sorted according to your custom order.
Newly added throttles (not yet in the saved order) are appended to the end, sorted by DCC address.
If a throttle is removed (released/parked), it is automatically cleaned from the saved order list.

Adding a Locomotive

An Add Throttle card sits at the start of the grid with two ways to acquire a locomotive:

By Address -- type a DCC address to acquire that locomotive directly.
From Roster -- opens a roster drawer listing every locomotive on your layout, each shown as a number plate. Tap one to acquire it.

Either way, a new tile appears in the grid right away and the DEJA.js server begins controlling that address.

Navigating to Full Control

Tapping (or double-clicking) the number plate on any tile navigates you to the full Throttle Control screen for that locomotive at /throttle/:address.

Background

The Throttle List screen features a dark background with three large, blurred gradient orbs (purple, blue, and violet) positioned at different corners, providing subtle depth without distracting from the tile content.