Nuxt Swiftsearch
Composables

useAisRouter

Nuxt-aware router adapter for InstantSearch routing.

useAisRouter() returns an adapter compatible with InstantSearch routing.

Usage

components/SearchExperience.vue
const algoliaRouter = useAisRouter();

const configuration = {
  indexName: "instant_search",
  searchClient,
  routing: {
    router: algoliaRouter.value.router,
    stateMapping: singleIndexMapping("instant_search"),
  },
};

Behavior

  • Reads current Nuxt route query to hydrate InstantSearch state.
  • Writes query updates via router.push.
  • Avoids redundant writes when route state is unchanged.
  • Subscribes to route updates to keep search state in sync.
  • useAisIndex() for building nested index widgets manually.
  • useAis*() connector composables when you opt into manual :widgets mode.
Copyright © 2026