Motia Icon
Core Concepts

Workbench

Visualize, test, and debug your Motia flows with the built-in development platform

Motia Workbench

Motia Workbench is a development platform that helps you build and debug your Motia flows. It serves as your control center where you can:

  • Visualize flows as interactive diagrams
  • Test steps directly in the UI
  • Monitor real-time logs
  • Debug issues

Flow Visualization in Workbench

Getting Started

Start workbench by running:

npm run dev

Running the dev command starts:

  • Motia Server: Backend services and API endpoints
  • Motia Workbench: Web interface at http://localhost:3000
  • Development Mode: Auto-reloads when changes are made

Key Features

Flow Visualization

See your entire flow as an interactive diagram:

  • Steps appear as connected nodes
  • API endpoints are highlighted as entry points
  • Event connections show data flow
  • Click any step to see its details

Real-time Testing

Test your flows directly in the interface:

  • Send test requests to API endpoints
  • Monitor how events flow through steps
  • Visualize step sequence execution
  • Inspect data at each stage

Live Logs

Monitor your flow execution in real-time with structured logging and trace information.

Development Tools

  • Hot Reload: Changes reflect immediately in the UI
  • Error Handling: Detailed error messages with contextual debugging information
  • State Inspector: Real-time monitoring of state management
New to Motia? Follow the quick start guide to get set up.
Need help? See our Community Resources for questions, examples, and discussions.

On this page