workflow-id-matches-export-or-filename - ESLint plugin rules

This rule requires a workflow's ID, the first argument of createWorkflow, to be a kebab-case string that matches the exported workflow name or filename.

Severity#

warn. This rule is enabled in the recommended preset.

What it Targets#

This rule targets files in your project's src/workflows directory. It reports a createWorkflow ID that:

• isn't kebab-case.
• doesn't match the exported workflow name, with a trailing Workflow segment stripped.
• doesn't match the filename.

The following code is reported by the rule:

src/workflows/example.ts
1import {2  createWorkflow,3  WorkflowResponse,4} from "@medusajs/framework/workflows-sdk"5
6export const helloWorldWorkflow = createWorkflow(7  "helloWorldWorkflow",8  (input) => {9    return new WorkflowResponse({ ok: true })10  }11)

Instead, use a kebab-case ID that matches the workflow name:

src/workflows/example.ts
1import {2  createWorkflow,3  WorkflowResponse,4} from "@medusajs/framework/workflows-sdk"5
6export const helloWorldWorkflow = createWorkflow(7  "hello-world",8  (input) => {9    return new WorkflowResponse({ ok: true })10  }11)

Why it's Important#

Using a consistent, kebab-case ID that matches the workflow's exported name or filename makes workflows easier to identify and reference.

Learn more in the Workflows documentation.

Fixable#

This rule is auto-fixable. Run the linter with the --fix option to apply the fix automatically.

Turn it Off#

To turn off this rule, set it to off in your ESLint configuration:

eslint.config.ts
1import { defineConfig } from "eslint/config"2import medusa from "@medusajs/eslint-plugin"3
4export default defineConfig([5  ...medusa.configs.recommended,6  {7    rules: {8      "@medusajs/workflow-id-matches-export-or-filename": "off",9    },10  },11])

Or disable it for a single line using an inline comment:

Code
1// eslint-disable-next-line @medusajs/workflow-id-matches-export-or-filename2export const helloWorldWorkflow = createWorkflow(