> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/vercel/workflow/llms.txt
> Use this file to discover all available pages before exploring further.

# workflow dev

> Start development server with file watching

## Usage

```bash theme={null}
workflow dev [options]
```

Or using the short alias:

```bash theme={null}
wf dev [options]
```

## Status

This command is currently in development. When available, it will provide:

* File watching for workflow changes
* Development server for local workflows
* Better error messages and debugging

## Options

<ParamField path="--port" type="number" default="3000">
  Port to run dev server on.

  **Alias:** `-p`

  **Example:**

  ```bash theme={null}
  workflow dev --port 3001
  workflow dev -p 3001
  ```
</ParamField>

<ParamField path="--target" type="string" default="standalone">
  Build target for development.

  **Alias:** `-t`

  **Options:**

  * `standalone`
  * `vercel-build-output-api`

  **Example:**

  ```bash theme={null}
  workflow dev --target standalone
  workflow dev -t vercel-build-output-api
  ```
</ParamField>

## Examples

### Default Configuration

```bash theme={null}
workflow dev
```

Runs on port 3000 with standalone target.

### Custom Port

```bash theme={null}
workflow dev --port 3001
```

### Custom Target

```bash theme={null}
workflow dev --target vercel-build-output-api
```

### Combined Options

```bash theme={null}
workflow dev --port 8080 --target standalone
```

## Current Output

When run, the command currently displays:

```bash theme={null}
$ workflow dev

🚧 Development server is coming soon!

This command will provide:
• File watching
• Development server for local workflows
• Better error messages and debugging

Configured to run on port: 3000
Build target: standalone

For now, use: workflow build --target <target>
```

## Planned Features

When implemented, this command will:

1. **File Watching**: Automatically detect changes to workflow files
2. **Hot Reload**: Rebuild workflows when files change
3. **Dev Server**: Run a local server for testing workflows
4. **Enhanced Debugging**: Provide better error messages and stack traces
5. **Live Logs**: Show real-time logs of workflow execution

## Alternative

Until `workflow dev` is available, use the build command:

```bash theme={null}
workflow build --target standalone
```

For development with framework integrations, use the framework's dev server:

```bash theme={null}
# Next.js
npm run dev

# Nuxt
npm run dev

# Astro
npm run dev

# SvelteKit
npm run dev
```

These automatically watch for workflow changes and rebuild as needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.