Nuxt-scheduler: A server side scheduling module for Nuxt 3

Schedule Jobs within Nuxt 3.

This is a Server-Side task scheduler for Nuxt which depends on node-cron.

Features

  • Human readable
  • Easy to use

Quick Setup

  1. Add nuxt-scheduler dependency to your project
# Using pnpm
pnpm add -D nuxt-scheduler

# Using yarn
yarn add --dev nuxt-scheduler

# Using npm
npm install --save-dev nuxt-scheduler
  1. Add nuxt-scheduler to the modules section of nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    'nuxt-scheduler'
  ]
})

That's it! You can now use Nuxt Scheduler in your Nuxt app 

Example Usage

Create as many scheduler you like as plugins.

~/server/plugins/smileScheduler.ts

import { useScheduler } from "#scheduler"
import say from "~~/server/app/services/say";

export default defineNitroPlugin(() => {
  startScheduler()
})

function startScheduler() {
  const scheduler = useScheduler();

  scheduler.run(() => {
    say("cool beans! I run once a second! ");
  }).everySecond();

  // create as many tasks as you want here
}

Each scheduler can have multiple tasks

~/server/plugins/rocketScheduler.ts

import { useScheduler } from "#scheduler"
import say from "~~/server/app/services/say";

export default defineNitroPlugin(() => {
  startScheduler()
})

function startScheduler() {
  const scheduler = useScheduler();

  scheduler.run(() => {
    say("I run every 3 seconds");
  }).everySeconds(3);

  scheduler.run(() => {
    say("I run every 5 seconds");
  }).everySeconds(5);

  // create as many tasks as you want here
}

use Human Readable intervals

 everySecond
 everySeconds
 everyMinute
 everyMinutes
 everyTwoMinutes
 everyThreeMinutes
 everyFourMinutes
 everyFiveMinutes
 everyTenMinutes
 everyFifteenMinutes
 everyThirtyMinutes
 hourly
 hourlyAt
 everyOddHour
 everyHours
 everyTwoHours
 everyThreeHours
 everyFourHours
 everySixHours
 daily
 dailyAt
 everyDays
 weekly
 quarterly
 yearly

or set using cron syntax

cron('* * * * *')

Development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

# Release new version
npm run release

Chckout this awesome youtube tutorial as well

https://www.youtube.com/watch?v=7P6AEs3maUU