inngest-nextjs-patterns

name

inngest-nextjs-patterns

description

Inngest event-driven functions in a Next.js (App Router) project — creating the client, the /api/inngest route handler, typed events with Zod schemas, durable event-triggered functions, scheduled cron functions, or fan-out orchestrators. Trigger when scaffolding Inngest patterns — and even if the user just says "add a background job", "process this async", "schedule X every hour", or "send an event when Y happens" in a Next.js codebase. Also trigger when reviewing existing Inngest code to enforce event-naming, function-id stability, and step-idempotency conventions.

Inngest + Next.js Patterns

Templates and conventions for building event-driven, durable background work on Inngest from a Next.js App Router project. The skill enforces the conventions Inngest's own docs use (decentralized eventType() schemas, kebab-case stable function IDs, idempotent steps) so that retries, replays, and concurrency controls actually do what they advertise.

When to Apply

Read this skill when you are:

• Setting up Inngest in a Next.js app for the first time (client + route handler + first function)
• Adding a new background job, webhook handler, or scheduled task to a Next.js app
• Defining a new domain event that other functions will trigger on
• Orchestrating multi-step work that must survive process restarts (durable workflows, sagas)
• Reviewing existing Inngest code for event naming, step idempotency, or stable function IDs
• Migrating from setTimeout / a queue library / a cron service to Inngest's durable execution model

How to Use

1. First time in this codebase? Read references/conventions.md before writing anything. The conventions explain why event names take a specific shape, why function IDs must be stable, and why every step.run must be idempotent — once you understand the reasoning, the templates make sense.