Nuxt · Routing

NUXT0050Use NuxtLink for internal navigation

Finds Nuxt routing code that should use the supported NuxtLink pattern instead.

Why it happens

NuxtLink handles client navigation, route prefetching, base paths, and external-link behavior for Nuxt applications.

Fix

Use <NuxtLink> for internal navigation.

Example

Before

<template>
  <a href="/dashboard">Dashboard</a>
</template>

After

<template>
  <NuxtLink to="/dashboard">Dashboard</NuxtLink>
</template>

Verify the fix

Run only this rule after editing so the report stays focused on the diagnostic you are closing:

pnpm nuxt doctor --rules nuxt/routing/prefer-nuxtlink
Copyright © 2026