nuxt-feathers-zodFeathersJS v5 + Zod for Nuxt 4

A backend-first Nuxt module to embed Feathers inside Nitro or connect a typed Feathers client to a remote API, with a CLI-first workflow designed for real package publishing.

Getting started

Main starter

CLI reference

Two modes, one workflow

Embedded when Feathers runs inside Nitro, remote when Nuxt consumes an external Feathers API.

CLI-first

Init, services, remote services, middleware and server modules are generated in a deterministic way.

Optional Zod-first

Use generated Zod schemas, query/data validation and shared types when you need them.

Main Quasar starter

Nuxt 4 + Quasar 2 + UnoCSS + Pinia + MongoDB model with local auth, session middleware, RBAC and a Feathers facade.

Real authentication paths

Local/JWT auth, Keycloak SSO compatibility and a dedicated client auth runtime.

Packaging confidence

Build, typecheck, E2E and tarball smoke checks are part of the public release discipline.

Community-ready

FR/EN docs, contribution workflow, release checklist and a cleaner public repository surface.

Start here

Pick the path that matches your first goal:

Understand NFZ in 5 minutes → Getting started
Start a complete business dashboard → Main Quasar + UnoCSS + Pinia starter
Build an embedded Feathers backend inside Nuxt → Embedded / remote modes
Connect a Nuxt frontend to a remote Feathers API → Remote mode
Publish or maintain the OSS package → npm & Git publishing

What NFZ is really about

nuxt-feathers-zod is not just a client SDK. It is a Nuxt 4 + Feathers v5 foundation for teams who want:

an embedded server inside Nitro when a mono-repo full-stack app makes sense,
a remote client layer when the API already exists elsewhere,
a CLI that generates the important pieces instead of hand-wiring them,
a path toward auth, Mongo management, diagnostics and builder tooling.

Shortest supported path

bash

bunx nuxi@latest init my-nfz-app
cd my-nfz-app
bun install
bun add nuxt-feathers-zod
bun add -D @pinia/nuxt
bunx nuxt-feathers-zod init embedded --force
bunx nuxt-feathers-zod add service users
bun dev

Golden rules

Keep feathers.servicesDirs = ['services'].
Generate services through the CLI.
Do not hand-create your first service if you want to stay on the supported path.
In remote mode, feathers.templates.dirs stays optional.

Recommended guides

Release discipline

The public module is now aligned around four simple checks: