Netlify Queue
Configure Netlify Async Workloads and run named queues on Netlify.
Netlify Queue fits apps that want to use Netlify Async Workloads as the background execution layer. ViteHub discovers queue files and forwards sends and handler setup through the Netlify provider integration.
Install the SDK
Terminal
pnpm add https://pkg.pr.new/nuxt-hub/agent/@vitehub/queue@main @netlify/async-workloads
Configure Netlify
nuxt.config.ts
export default defineNuxtConfig({
modules: ['@vitehub/queue/nuxt'],
})
Netlify hosting picks the queue provider automatically. ViteHub defaults event to the discovered queue name when you omit it. Add event only when the Netlify event name should differ from the filename. Add baseUrl and apiKey when your app needs to publish outside Netlify's default runtime setup.
Define a queue
server/queues/welcome-email.ts
import { defineQueue } from '@vitehub/queue'
export default defineQueue(async (job) => {
return {
email: job.payload?.email,
}
}, {
config: {
eventName: 'welcome-email',
maxConcurrency: 2,
},
})
What changes on Netlify
| Concern | Behavior |
|---|---|
| Event routing | queue.event defaults to the discovered queue name and can override it when needed. |
| Provider handle | The provider exposes sendEvent() and createHandler() for provider-native integration points. |
| Local options | Put Async Workloads handler configuration inside defineQueue(..., options) with config when one queue needs provider-specific overrides. |
Choose Netlify when your background execution should follow Netlify's Async Workloads model instead of a traditional queue client.