Compatibility matrix

This matrix describes the validated target perimeter of the open-source core.

Target versions

• Bun: 1.3.x
• Nuxt: 4.x
• Nitro: 2.x through Nuxt 4
• Vue: 3.5.x through Nuxt 4
• FeathersJS: v5 (Dove)
• TypeScript: 5.x

Supported core scenarios

Scenario	Target status	Notes
Nuxt 4 + embedded + memory	Stable	Recommended minimal entry point
Nuxt 4 + embedded + MongoDB	Stable	CLI generation recommended
Nuxt 4 + embedded + PostgreSQL through Knex	Stable optional path	Requires @feathersjs/knex, knex, and pg
Nuxt 4 + embedded + MySQL/MariaDB through Knex	Stable optional path	Requires mysql2
Nuxt 4 + embedded + SQLite through Knex	Stable optional path	Requires better-sqlite3
Several named MongoDB/SQL connections	Stable in 6.7.0	Every persistent service may select --connection
Nuxt 4 + embedded + local/JWT auth	Stable	Generate the users service through the CLI
Nuxt 4 + remote REST	Stable	Declare remote services explicitly
Nuxt 4 + remote Socket.IO	Stable	Uses the same declared-service model
Keycloak SSO bridge	Stable with correct configuration	Validate against the real identity environment
Legacy Swagger	Stable optional path	Requires feathers-swagger and swagger-ui-dist

Priority validation platforms

• Windows 11 + Bun
• Linux + Bun

Preserved invariants

• servicesDirs: ['services'] remains the recommended public convention;
• CLI-first initialization and service generation;
• memory remains the default adapter;
• --schema none remains the default schema mode;
• named connection diagnostics never expose credentials;
• legacy aliases remain supported but are not promoted as the primary architecture.

Recommended smoke sequence

bun install
bun run sanity:templates
bun run sanity:syntax
bun run sanity:database-registry
bun run build
bun run docs:build