npmx.dev / app / router.options.ts

import type { RouterConfig } from 'nuxt/schema'

export default {
  scrollBehavior(to, _from, savedPosition) {
    // If the browser has a saved position (e.g. back/forward navigation), restore it
    if (savedPosition) {
      return savedPosition
    }

    // If navigating to a hash anchor, scroll to it
    if (to.hash) {
      return { el: to.hash, behavior: 'smooth' }
    }

    // Otherwise, scroll to the top of the page
    return { left: 0, top: 0 }
  },
} satisfies RouterConfig