ui-route-config-via-define-route-config - ESLint plugin rules

This rule requires a UI route config export to be initialized with defineRouteConfig.

Severity#

warn. This rule is enabled in the recommended preset.

What it Targets#

This rule targets page.tsx files in your project's src/admin/routes directory. It reports a config export that isn't initialized with defineRouteConfig from @medusajs/admin-sdk.

The following code is reported by the rule:

src/admin/routes/custom/page.tsx
const CustomPage = () => <>Custom</>

export const config = {
  label: "Custom",
}

export default CustomPage

Instead, initialize config with defineRouteConfig:

src/admin/routes/custom/page.tsx
import { defineRouteConfig } from "@medusajs/admin-sdk"

const CustomPage = () => <>Custom</>

export const config = defineRouteConfig({
  label: "Custom",
})

export default CustomPage

Why it's Important#

The defineRouteConfig helper provides the expected type and structure for a route's sidebar configuration, so Medusa can register the route correctly.

Learn more in the UI Routes documentation.

Fixable#

This rule isn't auto-fixable.

Turn it Off#

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

eslint.config.ts
import { defineConfig } from "eslint/config"
import medusa from "@medusajs/eslint-plugin"

export default defineConfig([
  ...medusa.configs.recommended,
  {
    rules: {
      "@medusajs/ui-route-config-via-define-route-config": "off",
    },
  },
])

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

Code
// eslint-disable-next-line @medusajs/ui-route-config-via-define-route-config
export const config = {
Was this page helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Docs MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break
⇧↵