Plugins

Plugins let you extend Pinia Colada globally (retries, refetch policies, persistence, global hooks, logging…) without changing every useQuery() / useMutation() call.

A plugin is an install-time function registered when you install Pinia Colada:

import { PiniaColada } from '@pinia/colada'

app.use(PiniaColada, {
  plugins: [
    // plugin factories return a plugin function
    // Some plugins are built into `@pinia/colada`, others are separate packages.
  ],
})

Using plugins

Most plugins follow the same workflow:

1. Install the package (if it’s not built-in)
2. Add it to the plugins array
3. Optionally configure it globally (plugin options) and/or locally (per query/mutation options)

Plugin order matters: if multiple plugins hook the same cache actions, they run in installation order.

Official and Community plugins

See Official plugins and Community plugins.

Writing plugins

If you want to create your own plugin (or understand how existing ones work), see Writing plugins.