⚠️ Nuxt 3.4 introduced a breaking change in its router output.
Install a version superior > v3.1.4
of nuxt-typed-router if you're using this Nuxt version
Provide a type safe router to Nuxt with auto-generated typed definitions for route path, name and params
- Supports all programmatic navigation utils (
NuxtLink
, useRouter
, navigateTo
, useRoute
, useLocalePath
, etc...) - Supports optional params and catchAll routes
- Autocompletes routes paths, names and params
- Throw error if route path is invalid
- Out of the box
i18n
support - Supports routes extended by config and modules
Documentation
Play with it
Demo repo 🧪 : nuxt-typed-router-demo
Cool video about it from LearnVue!
Compatibility:
Quick start
For Nuxt 3
yarn add -D nuxt-typed-router
npm install -D nuxt-typed-router
pnpm install -D nuxt-typed-router
Nuxt 2 legacy (not maintained)
Nuxt 2 version is no longer maintained, but still available in nuxt2
branch
It only has route name autocomplete functionnality
yarn add -D nuxt-typed-router@legacy
npm install -D nuxt-typed-router@legacy
Configuration
Register the module in the nuxt.config.ts
, done!
export default defineNuxtConfig({
modules: ['nuxt-typed-router'],
});
Development
- Clone this repository
- Install dependencies using
pnpm
- Build project for local tests
pnpm run test
- Start dev playground
pnpm run prepack && pnpm run dev
- Build project for deploy
pnpm prepack
📑 License
MIT License