Dashboard

Goal

layer dashboard starts the Layeron dashboard for a local project. The dashboard reads Layeron project state, deployment records, resource metadata, secret metadata, and Worker Logs records for Workers in the selected environment.

The command serves the dashboard on a local HTTP origin. The default URL is http://127.0.0.1:4177.

Command

layer dashboard [project] [options]

Options

Option	Value	Notes
--env	<name>	Initial environment selection.
--workspace-id	<id>	Workspace id. Defaults to local.
--project-id	<id>	Project id override.
--host	<address>	Local listen address. Defaults to 127.0.0.1.
--port	<number>	Local port. Defaults to 4177; valid range is 1 through 65535.
-h, --help		Show help.

Project State

The project argument points to the Layeron project directory. Omit it to use the current directory.

Dashboard state uses the same project-local .layeron directory as direct deploy, resource, log, and secret commands. Cloudflare-backed views use the Cloudflare credentials stored by layer login.

Theme

The dashboard has a Theme menu with Auto, Light, and Dark choices. Auto uses the operating system color scheme and updates when the system preference changes. Light and Dark keep the selected theme for future dashboard visits in the same browser.

Examples

Run the dashboard for the current project:

layer dashboard

Run the dashboard for a project directory:

layer dashboard ./apps/api

Choose the initial environment and local port:

layer dashboard . --env production --port 4180

Bind the dashboard to a custom local address:

layer dashboard . --host 127.0.0.1 --port 4180

Troubleshooting

Use --port when another local process already uses port 4177.

Run layer login status when Cloudflare-backed dashboard views need account access.