Skip to content

Explore the module with the playground ​

The playground is a complete Nuxt application that demonstrates module features in a browser. Use it to understand a workflow before reproducing the configuration in your own project.

Start it ​

From the source repository:

bash
bun install --frozen-lockfile
bun run dev

Then open the URL printed by Nuxt.

Dashboard ​

The dashboard checks Nuxt configuration, the Feathers client, a public service, authentication, a protected service, and SSR hydration.

Playground quick checks

The Run quick checks action does not change persistent data.

Connection and session diagnostics ​

The Essential tests page checks a service first and then a local session. It displays useful details for diagnosing a transport or authentication issue.

In the local scenario, the Messages page requires an authenticated session at both the route and Feathers service layers. Sign out closes the session, clears protected page data, and returns to the dashboard. Direct anonymous access to /messages is redirected to a public page and the messages API returns 401.

Service and authentication diagnostics

Useful workflows ​

Each route maps to a real playground screen. Diagnostic pages remain available without a session; protected business pages request authentication when their scenario requires it.

RoutePageWhat you can test
/Dashboardoverall status and quick checks
/testsEssential testsservice, local session, and token
/validationZod validationschemas and validation errors
/messagesMessagesprotected Feathers CRUD
/actionsActionscustom service method
/mongoMongoDBconnection diagnostics and administration when MongoDB is enabled
/builderBuilderoverview of generation features
/auth-runtimeAuthenticationprincipal, events, and provider
/embeddedEmbedded modeFeathers backend integrated into Nuxt
/remote/restRemote RESTHTTP connection to a remote API
/remote/socketioRemote Socket.IOreal-time transport and reconnection
/middlewareServer middlewaremodule, plugin, and service ordering
/ldapusersRemote serviceldapusers service example
/mongosMongos serviceFeathers reads and Pinia state
/console/builderBuilder consoleNFZ generation console
/console/rbacRBAC consoleroles and capabilities

Trustworthy screenshots ​

Documentation images are produced by playground Playwright scenarios. A screenshot is updated only after the related functional assertions pass.

Demo data ​

The playground uses test-only identities and secrets. Never copy those values into production.

nuxt-feathers-zod user documentation