vue-query
Go to documentation0 config lightweight Nuxt module for @tanstack/vue-query.
⚗️ 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.
# npm
npm i @hebilicious/vue-query-nuxt @tanstack/vue-query
# pnpm
pnpm i @hebilicious/vue-query-nuxt @tanstack/vue-query
# yarn
yarn add @hebilicious/vue-query-nuxt @tanstack/vue-query
2. Add the modules to your Nuxt modules
In nuxt.config.ts
:
export default defineNuxtConfig({
modules: ["@hebilicious/vue-query-nuxt"]
})
3. Use right away
In a vue component :
<script setup lang="ts">
// Access QueryClient instance
const queryClient = useQueryClient()
// Query
const { isLoading, isError, data, error } = useQuery({
queryKey: ['todos'],
queryFn: () => $fetch("/api/todos"), // Use $fetch with your api routes to get typesafety
})
// Mutation
const { mutate } = useMutation({
mutationFn: (newTodo) => $fetch("/api/todos", { method: "POST", body: newTodo })
onSuccess: () => {
// Invalidate and refetch
queryClient.invalidateQueries({ queryKey: ['todos'] })
},
})
function onButtonClick() {
mutate({
id: Date.now(),
title: 'Do Laundry',
})
}
</script>
<template>
<span v-if="isLoading">Loading...</span>
<span v-else-if="isError">Error: {{ error.message }}</span>
<!-- We can assume by this point that `isSuccess === true` -->
<ul v-else>
<li v-for="todo in data" :key="todo.id">{{ todo.title }}</li>
</ul>
<button @click="onButtonClick">Add Todo</button>
</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
:
export default defineNuxtConfig({
modules: ["@hebilicious/vue-query-nuxt"],
vueQuery: {
// useState key used by nuxt for the vue query state.
stateKey: "vue-query-nuxt", // default
// If you only want to import some functions, specify them here.
// You can pass false or an empty array to disable this feature.
// default: ["useQuery", "useQueries", "useInfiniteQuery", "useMutation", "useIsFetching", "useIsMutating", "useQueryClient"]
autoImports: ["useQuery"],
// Pass the vue query client options here ...
queryClientOptions: {
defaultOptions: { queries: { staleTime: 5000 } } // default
},
// Pass the vue query plugin options here ....
vueQueryPluginOptions: {}
}
})
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
:
import { library } from "@example/libray"
export default defineVueQueryPluginCallback((vueQueryOptions) => {
console.log(vueQueryOptions) // You can access the queryClient here
return { provide: { library, test: console } }
})
This callback will be run directly after the Vue Query plugin is installed, so you can use it to provide
something.
This can be useful if you want to configure something that needs the queryClient
or you want to provide a library in the same plugin.
📦 Contributing
Contributions, issues and feature requests are welcome!
- Fork this repo
- Install
node
andpnpm
Usecorepack enable && corepack prepare pnpm@latest --activate
to install pnpm easily - Use
pnpm i
at the mono-repo root. - Make modifications and follow conventional commits.
- Open a PR 🚀🚀🚀