⚗️ Vue Query Nuxt

🚀 Welcome to Vue Query Nuxt!

This Nuxt Module automatically installs and configure Vue Query for your Nuxt application. It has 0 config out-of-the box and extremely lightweight.

Features

• 0 config out-of-the box
• All configurations options available
• Auto Imports for Vue Query composables

Refer to the Vue Query documentation for more information about Vue Query.

📦 How to use

1. Use npm, pnpm or yarn to install the dependencies.

1# npm
2npm i @hebilicious/vue-query-nuxt @tanstack/vue-query  
3# pnpm
4pnpm i @hebilicious/vue-query-nuxt @tanstack/vue-query  
5# yarn
6yarn add @hebilicious/vue-query-nuxt @tanstack/vue-query  

2. Add the modules to your Nuxt modules

In nuxt.config.ts :

1export default defineNuxtConfig({
2  modules: ["@hebilicious/vue-query-nuxt"]
3})

3. Use right away

In a vue component :

1<script setup lang="ts">
2// Access QueryClient instance
3const queryClient = useQueryClient()
4
5// Query
6const { isLoading, isError, data, error } = useQuery({
7  queryKey: ['todos'],
8  queryFn: () => $fetch("/api/todos"), // Use $fetch with your api routes to get typesafety 
9})
10
11// Mutation
12const { mutate } = useMutation({
13  mutationFn: (newTodo) => $fetch("/api/todos", { method: "POST", body: newTodo })
14  onSuccess: () => {
15    // Invalidate and refetch
16    queryClient.invalidateQueries({ queryKey: ['todos'] })
17  },
18})
19
20function onButtonClick() {
21   mutate({
22    id: Date.now(),
23    title: 'Do Laundry',
24  })
25}
26</script>
27
28<template>
29  <span v-if="isLoading">Loading...</span>
30  <span v-else-if="isError">Error: {{ error.message }}</span>
31  <!-- We can assume by this point that `isSuccess === true` -->
32  <ul v-else>
33    <li v-for="todo in data" :key="todo.id">{{ todo.title }}</li>
34  </ul>
35  <button @click="onButtonClick">Add Todo</button>
36</template>

4. Advanced configuration

You can specify the options under the vueQuery key in your nuxt.config.ts file. Everything is typed.

In nuxt.config.ts :

1export default defineNuxtConfig({
2  modules: ["@hebilicious/vue-query-nuxt"],
3  vueQuery: {
4    // useState key used by nuxt for the vue query state.
5    stateKey: "vue-query-nuxt", // default
6    // If you only want to import some functions, specify them here.
7    // You can pass false or an empty array to disable this feature.
8    // default: ["useQuery", "useQueries", "useInfiniteQuery", "useMutation", "useIsFetching", "useIsMutating", "useQueryClient"]
9    autoImports: ["useQuery"],
10    // Pass the vue query client options here ...
11    queryClientOptions: {
12      defaultOptions: { queries: { staleTime: 5000 } } // default
13    },
14    // Pass the vue query plugin options here ....
15    vueQueryPluginOptions: {}
16  }
17})

If you need to modify the plugin that installs vue query, you can create a vue-query.config.ts file at the root of your project.

In vue-query.config.ts :

1import { library } from "@example/libray"
2
3export default defineVueQueryPluginHook(({ queryClient, nuxt }) => {
4  console.log(queryClient, nuxt) // You can access the queryClient here
5  return {
6    pluginReturn: { provide: { library, test: console } }, // nuxt plugin return value
7    vueQueryPluginOptions: { queryClient } // You can pass dynamic options
8  }
9})

This hook will be run within the nuxt plugin installed by the module, so you can use it to provide something or replace the vue query options. This can be useful if you need to run custom logic when the queryClient is being installed.

📦 Contributing

Contributions, issues and feature requests are welcome!

1. Fork this repo

2. Install node and pnpm Use corepack enable && corepack prepare pnpm@latest --activate to install pnpm easily

3. Use pnpm i at the mono-repo root.

4. Make modifications and follow conventional commits.

5. Open a PR 🚀🚀🚀