@vevedh/create-feathers-app 0.0.0-stage → 0.1.0-rc.1

package/templates/daisyui-ssg/gitignore.template

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+.env*
+!.env.example
+*.log
+coverage/
+test-results/
+playwright-report/
+.agents/
+.ai/
+.codex/
+.cursor/
+.claude/
+.mcp.json
+.vscode/mcp.json
+docs-private/

package/templates/daisyui-ssg/index.html

@@ -0,0 +1,2 @@
+<!doctype html><html lang="fr"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>DaisyUI Feathers — SSR/SSG</title><meta name="r17-example" content="daisyui-ssg"><link rel="icon" href="data:,"></head>
+<body><div id="app"><!--app-html--></div><script type="module" src="/src/entry-client.ts"></script></body></html>

package/templates/daisyui-ssg/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "r17-daisyui-ssg",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.30.2",
+  "engines": {
+    "node": ">=22.12"
+  },
+  "scripts": {
+    "dev:api": "node api/server.mjs",
+    "typecheck": "vue-tsc --noEmit",
+    "build": "vite build --outDir dist/client && vite build --ssr src/entry-server.ts --outDir dist/server && node scripts/prerender.mjs",
+    "dev": "vite --host 127.0.0.1 --port 5173",
+    "serve:production": "node scripts/serve-static.mjs"
+  },
+  "dependencies": {
+    "@vevedh/vite-plugin-feathersjs": "0.2.6",
+    "@feathersjs/feathers": "^5.0.50",
+    "@feathersjs/errors": "^5.0.50",
+    "@feathersjs/koa": "^5.0.50",
+    "@feathersjs/express": "^5.0.50",
+    "@feathersjs/socketio": "^5.0.50",
+    "vue": "^3.5.44",
+    "pinia": "^3.0.4",
+    "socket.io-client": "^4.8.4",
+    "@vue/server-renderer": "^3.5.44"
+  },
+  "devDependencies": {
+    "vite": "^7.3.7",
+    "@vitejs/plugin-vue": "^6.0.0",
+    "tailwindcss": "^4.1.0",
+    "@tailwindcss/vite": "^4.1.0",
+    "daisyui": "^5.0.0",
+    "vue-tsc": "^3.0.7",
+    "typescript": "^5.9.3",
+    "@types/node": "^22.0.0"
+  }
+}

package/templates/daisyui-ssg/scripts/prerender.mjs

@@ -0,0 +1,14 @@
+import { readFile, mkdir, writeFile, cp } from 'node:fs/promises'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const { render } = await import(pathToFileURL(resolve(root,'dist/server/entry-server.js')).href)
+const template = await readFile(resolve(root,'dist/client/index.html'),'utf8')
+for (const route of ['/', '/about']) {
+  const content = await render(route) // public markup only: no Feathers fetch or token
+  const directory = route === '/' ? resolve(root,'dist/ssg') : resolve(root,'dist/ssg/about')
+  await mkdir(directory,{recursive:true})
+  await writeFile(resolve(directory,'index.html'), template.replace('<!--app-html-->',content))
+}
+await cp(resolve(root,'dist/client/assets'), resolve(root,'dist/ssg/assets'),{recursive:true})
+console.log('PASS: SSG generated / and /about without dynamic notes')

package/templates/daisyui-ssg/scripts/serve-static.mjs

@@ -0,0 +1,32 @@
+import { createServer } from 'node:http'
+import { readFile } from 'node:fs/promises'
+import { resolve, dirname, extname, sep } from 'node:path'
+import { fileURLToPath } from 'node:url'
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'dist/ssg')
+const mime = { '.html':'text/html; charset=utf-8', '.js':'text/javascript', '.css':'text/css', '.png':'image/png', '.svg':'image/svg+xml', '.woff2':'font/woff2' }
+const server = createServer(async (req,res)=>{
+  try {
+    const pathname = new URL(req.url||'/', 'http://localhost').pathname
+    if (pathname.startsWith('/api/')) {
+      const target = new URL(pathname,'http://127.0.0.1:3030')
+      const method = req.method || 'GET'
+      const chunks = []
+      if (method !== 'GET' && method !== 'HEAD') for await(const chunk of req) {
+        chunks.push(chunk)
+        if (chunks.reduce((sum,item)=>sum+item.length,0)>65536) throw new Error('Request body too large')
+      }
+      const response = await fetch(target,{ method, headers: { accept:'application/json', 'content-type':req.headers['content-type']||'application/json' },body:chunks.length?Buffer.concat(chunks):undefined })
+      res.writeHead(response.status,{'content-type': response.headers.get('content-type')||'application/json'})
+      res.end(Buffer.from(await response.arrayBuffer()));return
+    }
+    if (!/^\/[a-zA-Z0-9._\/-]*$/.test(pathname) || pathname.includes('..')) {res.writeHead(400);res.end();return}
+    const rel = pathname === '/' ? 'index.html' : pathname === '/about' || pathname === '/about/' ? 'about/index.html' : pathname.slice(1)
+    const full=resolve(root,rel)
+    if (!full.startsWith(root+sep) && full !== resolve(root,'index.html')) {res.writeHead(403);res.end();return}
+    const body=await readFile(full)
+    res.writeHead(200, { 'content-type': mime[extname(full)] || 'application/octet-stream', 'cache-control': extname(full)==='.html' ? 'no-store' : 'public, max-age=60' })
+    res.end(body)
+  }
+  catch (error) {res.writeHead(error.code==='ENOENT'?404:500);res.end('Not found')}
+})
+server.listen(5173,'127.0.0.1',()=>console.log('SSG preview: http://127.0.0.1:5173'))

package/templates/daisyui-ssg/src/App.vue

@@ -0,0 +1,14 @@
+<script setup lang="ts">
+import NotesPanel from './components/NotesPanel.vue'
+defineProps<{ route: string }>()
+</script>
+<template>
+  <main class="min-h-screen bg-base-200 p-6"><div class="max-w-4xl mx-auto space-y-6">
+    <header class="navbar bg-base-100 rounded-box px-6 gap-4"><span class="font-bold">Feathers Console — daisyUI</span>
+      <a href="/" class="link">Accueil</a><a href="/about" class="link">À propos</a></header>
+    <h1 class="text-3xl font-semibold">{{ route === '/about' ? 'À propos de cet exemple' : 'Vue 3, Pinia et FeathersJS v5' }}</h1>
+    <p>Cette page publique ne contient aucune donnée personnelle. Les notes sont demandées au service Feathers après hydratation.</p>
+    <NotesPanel v-if="route !== '/about'" />
+    <p v-else>Rendu HTML public. API REST séparée et données de démonstration non prérendues.</p>
+  </div></main>
+</template>

package/templates/daisyui-ssg/src/components/NotesPanel.vue

@@ -0,0 +1,22 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref } from 'vue'
+import { useNotesStore } from '../stores/notes'
+const store = useNotesStore()
+const title = ref('')
+onMounted(() => { void store.load(); store.connectRealtime() })
+onUnmounted(() => store.disconnectRealtime())
+async function submit() { await store.create(title.value); if (!store.error) title.value = '' }
+</script>
+<template>
+  <section class="card bg-base-100 border border-base-300 shadow-lg"><div class="card-body">
+    <h2 class="card-title">Notes FeathersJS</h2>
+    <span class="badge badge-outline" data-testid="realtime-status">{{ store.realtimeConnected ? 'Temps réel connecté' : 'REST actif' }}</span>
+    <div v-if="store.error" class="alert alert-error" role="alert">{{ store.error }}</div>
+    <form class="flex gap-3 flex-wrap" @submit.prevent="submit">
+      <label class="input flex-1"><span class="label">Titre</span><input v-model="title" aria-label="Titre de la nouvelle note" maxlength="120" required /></label>
+      <button class="btn btn-primary" type="submit" :disabled="store.loading || !title.trim()">Créer une note</button>
+    </form>
+    <p data-testid="notes-count">{{ store.notes.length }} note(s)</p>
+    <ul data-testid="notes" class="list bg-base-200 rounded-box"><li v-for="note in store.notes" :key="note.id" class="list-row">{{ note.title }}</li></ul>
+  </div></section>
+</template>

package/templates/daisyui-ssg/src/entry-client.ts

@@ -0,0 +1,9 @@
+import { createApp, createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import App from './App.vue'
+import './style.css'
+const route = window.location.pathname.replace(/\/$/, '') || '/'
+// Static HTML in production is hydrated. A dev-only empty shell is mounted normally.
+const hydrated = Boolean(document.querySelector('#app')?.firstElementChild)
+const app = hydrated ? createSSRApp(App, { route }) : createApp(App, { route })
+app.use(createPinia()).mount('#app')

package/templates/daisyui-ssg/src/entry-server.ts

@@ -0,0 +1,9 @@
+import { createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import { renderToString } from 'vue/server-renderer'
+import App from './App.vue'
+export async function render(route: string): Promise<string> {
+  const app = createSSRApp(App, { route })
+  app.use(createPinia()) // fresh Pinia for every server-side render
+  return await renderToString(app)
+}

package/templates/daisyui-ssg/src/stores/notes.ts

@@ -0,0 +1,46 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { io, type Socket } from 'socket.io-client'
+export interface Note { id: number; title: string }
+const realtime = import.meta.env.VITE_FEATHERS_REALTIME === '1'
+export const useNotesStore = defineStore('notes', () => {
+  const notes = ref<Note[]>([])
+  const loading = ref(false)
+  const error = ref('')
+  const realtimeConnected = ref(false)
+  let socket: Socket | undefined
+  async function load(): Promise<void> {
+    try {
+      const response = await fetch('/api/notes', { headers: { Accept: 'application/json' } })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      const payload: unknown = await response.json()
+      if (!Array.isArray(payload)) throw new Error('Unexpected notes response')
+      notes.value = payload as Note[]
+      error.value = ''
+    }
+    catch (cause) { error.value = cause instanceof Error ? cause.message : 'API unavailable' }
+  }
+  async function create(title: string): Promise<void> {
+    if (loading.value || !title.trim()) return
+    loading.value = true
+    try {
+      const response = await fetch('/api/notes', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ title: title.trim() }),
+      })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      await load()
+    }
+    catch (cause) { error.value = cause instanceof Error ? cause.message : 'Create failed' }
+    finally { loading.value = false }
+  }
+  function connectRealtime(): void {
+    if (!realtime || typeof window === 'undefined' || socket) return
+    socket = io(window.location.origin, { path: '/socket.io', transports: ['websocket'] })
+    socket.on('connect', () => { realtimeConnected.value = true })
+    socket.on('disconnect', () => { realtimeConnected.value = false })
+    socket.on('notes created', () => { void load() })
+  }
+  function disconnectRealtime(): void { socket?.disconnect(); socket = undefined; realtimeConnected.value = false }
+  return { notes, loading, error, realtimeConnected, load, create, connectRealtime, disconnectRealtime }
+})

package/templates/daisyui-ssg/src/style.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+@plugin "daisyui";
+:root { font-family: ui-sans-serif, system-ui, sans-serif }

package/templates/daisyui-ssg/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/templates/daisyui-ssg/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "compilerOptions": { "target": "ES2022", "lib": ["ES2022", "DOM", "DOM.Iterable"], "module": "ESNext", "moduleResolution": "Bundler", "types": ["vite/client"], "strict": true, "exactOptionalPropertyTypes": true, "noUncheckedIndexedAccess": true, "isolatedModules": true, "skipLibCheck": true, "noEmit": true, "jsx": "preserve" },
+  "include": ["src/**/*.ts", "src/**/*.vue", "vite.config.ts"]
+}

package/templates/daisyui-ssg/vite.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import tailwindcss from '@tailwindcss/vite'
+export default defineConfig({ plugins: [vue(), tailwindcss()],
+  server: { host: '127.0.0.1', port: 5173, strictPort: true, proxy: { '/api': 'http://127.0.0.1:3030' } },
+})

package/templates/daisyui-ssr/.env.example

@@ -0,0 +1,6 @@
+# Local demonstration only. No secrets or private addresses.
+FEATHERS_ADAPTER=koa
+FEATHERS_API_PORT=3030
+FEATHERS_SOCKET_PORT=3031
+FEATHERS_SOCKETIO=0
+FEATHERS_PUBLIC_ORIGIN=http://127.0.0.1:5173

package/templates/daisyui-ssr/README.md

@@ -0,0 +1,21 @@
+# daisyUI SSR — FeathersJS v5
+
+Exemple de rendu SSR avec Vue 3, Pinia, Vite 7 et Tailwind CSS/daisyUI. Le service FeathersJS v5 est exécuté dans un processus indépendant. Les pages statiques ne contiennent pas de notes ni de secrets. Données de démonstration uniquement, sans authentification.
+
+```powershell
+corepack pnpm install
+# Terminal 1 : API Feathers
+corepack pnpm run dev:api
+# Terminal 2 : frontend
+corepack pnpm run dev
+```
+
+```powershell
+corepack pnpm run typecheck
+corepack pnpm run build
+corepack pnpm run serve:production
+```
+
+Le serveur de développement et de production rend deux routes (`/`, `/about`) avec un état Pinia distinct à chaque requête.
+
+La certification Windows complète reste à exécuter. Ne pas exposer publiquement l’API de démonstration en mémoire, sans authentification.

package/templates/daisyui-ssr/api/server.mjs

@@ -0,0 +1,45 @@
+import { createServer } from 'node:http'
+import { createFeathersRuntime } from '@vevedh/vite-plugin-feathersjs'
+const adapter = process.env.FEATHERS_ADAPTER === 'express' ? 'express' : 'koa'
+const port = Number(process.env.FEATHERS_API_PORT || 3030)
+const wsPort = Number(process.env.FEATHERS_SOCKET_PORT || 3031)
+const realtime = process.env.FEATHERS_SOCKETIO === '1'
+const origin = process.env.FEATHERS_PUBLIC_ORIGIN || 'http://127.0.0.1:5173'
+if (!Number.isInteger(port) || port < 1024 || port > 65535 || !Number.isInteger(wsPort) || wsPort === port) throw new Error('Invalid port configuration')
+const modules = [
+  new URL('./services/health/health.service.mjs', import.meta.url),
+  new URL('./services/notes/notes.service.mjs', import.meta.url),
+]
+const runtime = await createFeathersRuntime(modules.map(String), file => import(file), {
+  serviceFiles: [], adapter, prefix: '/api', cors: false,
+  socketio: realtime ? { port: wsPort, origins: [origin], host: '127.0.0.1' } : false,
+})
+await runtime.start()
+const httpServer = createServer((req, res) => {
+  const pathname = new URL(req.url || '/', 'http://localhost').pathname
+  if (pathname !== '/api' && !pathname.startsWith('/api/')) {
+    res.writeHead(404, { 'content-type': 'application/json' }); res.end('{"error":"Not found"}'); return
+  }
+  // The Feathers transport is mounted at /api, while its services register as health/notes.
+  req.url = (req.url || '/').slice(4) || '/'
+  runtime.handler(req, res, error => {
+    if (res.headersSent) { res.end(); return }
+    res.writeHead(500, { 'content-type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Internal server error' }))
+    if (error) console.error('[feathers] request failed')
+  })
+})
+await new Promise((resolve, reject) => {
+  httpServer.once('error', reject)
+  httpServer.listen(port, '127.0.0.1', resolve)
+})
+console.log(`Feathers ${adapter} API listening on http://127.0.0.1:${port}/api (socketio=${realtime})`)
+let stopping = false
+async function close() {
+  if (stopping) return
+  stopping = true
+  await new Promise(resolve => httpServer.close(resolve))
+  await runtime.close()
+}
+process.on('SIGINT', () => { void close().then(() => process.exit(0)) })
+process.on('SIGTERM', () => { void close().then(() => process.exit(0)) })

package/templates/daisyui-ssr/api/services/health/health.class.mjs

@@ -0,0 +1,3 @@
+export class HealthService {
+  async find() { return { status: 'ok', transport: 'feathers-v5' } }
+}

package/templates/daisyui-ssr/api/services/health/health.service.mjs

@@ -0,0 +1,4 @@
+import { HealthService } from './health.class.mjs'
+export default function register(app) {
+  app.use('health', new HealthService(), { methods: ['find'] })
+}

package/templates/daisyui-ssr/api/services/notes/notes.class.mjs

@@ -0,0 +1,25 @@
+import { NotFound, BadRequest } from '@feathersjs/errors'
+export class NotesService {
+  // Feathers v5 exposes service methods through its own service wrapper. The
+  // wrapper is not necessarily this class instance, so native #private slots
+  // cannot be read through an unbound method call. Bind to the owning instance.
+  // Keep this per-service-instance: never hoist records or IDs to module scope.
+  constructor() {
+    for (const name of ['find', 'get', 'create', 'patch', 'remove']) {
+      this[name] = this[name].bind(this)
+    }
+  }
+  #records = new Map([[1, { id: 1, title: 'Hello from FeathersJS v5' }]])
+  #nextId = 2
+  #id(value) { const n = Number(value); if (!Number.isSafeInteger(n) || n < 1) throw new BadRequest('Invalid note ID'); return n }
+  #title(value) {
+    const title = value?.title
+    if (typeof title !== 'string' || title.trim().length < 1 || title.length > 120) throw new BadRequest('Invalid note title')
+    return title.trim()
+  }
+  async find() { return [...this.#records.values()].map(note => ({ ...note })) }
+  async get(id) { const note = this.#records.get(this.#id(id)); if (!note) throw new NotFound('Note not found'); return { ...note } }
+  async create(data) { const note = { id: this.#nextId++, title: this.#title(data) }; this.#records.set(note.id, note); return { ...note } }
+  async patch(id, data) { const key = this.#id(id); if (!this.#records.has(key)) throw new NotFound('Note not found'); const note = { id: key, title: this.#title(data) }; this.#records.set(key, note); return { ...note } }
+  async remove(id) { const key = this.#id(id); const note = this.#records.get(key); if (!note) throw new NotFound('Note not found'); this.#records.delete(key); return { ...note } }
+}

package/templates/daisyui-ssr/api/services/notes/notes.service.mjs

@@ -0,0 +1,10 @@
+import { NotesService } from './notes.class.mjs'
+export default function register(app) {
+  app.use('notes', new NotesService(), { methods: ['find', 'get', 'create', 'patch', 'remove'] })
+  const service = app.service('notes')
+  // Demo-only channel: keep the entire stack loopback-only.
+  if (typeof service.publish === 'function') {
+    app.on('connection', connection => app.channel('local-demo').join(connection))
+    service.publish(() => app.channel('local-demo'))
+  }
+}

package/templates/daisyui-ssr/gitignore.template

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+.env*
+!.env.example
+*.log
+coverage/
+test-results/
+playwright-report/
+.agents/
+.ai/
+.codex/
+.cursor/
+.claude/
+.mcp.json
+.vscode/mcp.json
+docs-private/

package/templates/daisyui-ssr/index.html

@@ -0,0 +1,2 @@
+<!doctype html><html lang="fr"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>DaisyUI Feathers — SSR/SSG</title><meta name="r17-example" content="daisyui-ssr"><link rel="icon" href="data:,"></head>
+<body><div id="app"><!--app-html--></div><script type="module" src="/src/entry-client.ts"></script></body></html>

package/templates/daisyui-ssr/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "r17-daisyui-ssr",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.30.2",
+  "engines": {
+    "node": ">=22.12"
+  },
+  "scripts": {
+    "dev:api": "node api/server.mjs",
+    "typecheck": "vue-tsc --noEmit",
+    "build": "vite build --outDir dist/client && vite build --ssr src/entry-server.ts --outDir dist/server",
+    "dev": "node scripts/serve-ssr.mjs",
+    "serve:production": "node scripts/serve-ssr.mjs"
+  },
+  "dependencies": {
+    "@vevedh/vite-plugin-feathersjs": "0.2.6",
+    "@feathersjs/feathers": "^5.0.50",
+    "@feathersjs/errors": "^5.0.50",
+    "@feathersjs/koa": "^5.0.50",
+    "@feathersjs/express": "^5.0.50",
+    "@feathersjs/socketio": "^5.0.50",
+    "vue": "^3.5.44",
+    "pinia": "^3.0.4",
+    "socket.io-client": "^4.8.4",
+    "@vue/server-renderer": "^3.5.44"
+  },
+  "devDependencies": {
+    "vite": "^7.3.7",
+    "@vitejs/plugin-vue": "^6.0.0",
+    "tailwindcss": "^4.1.0",
+    "@tailwindcss/vite": "^4.1.0",
+    "daisyui": "^5.0.0",
+    "vue-tsc": "^3.0.7",
+    "typescript": "^5.9.3",
+    "@types/node": "^22.0.0"
+  }
+}

package/templates/daisyui-ssr/scripts/serve-ssr.mjs

@@ -0,0 +1,47 @@
+import { createServer } from 'node:http'
+import { readFile, realpath } from 'node:fs/promises'
+import { resolve, dirname, extname, sep } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { createServer as createViteServer } from 'vite'
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const prod = process.env.NODE_ENV === 'production'
+const vite = prod ? undefined : await createViteServer({ root, server: { middlewareMode: true }, appType: 'custom' })
+const html = prod ? await readFile(resolve(root,'dist/client/index.html'),'utf8') : await readFile(resolve(root,'index.html'),'utf8')
+const renderer = prod ? (await import(pathToFileURL(resolve(root,'dist/server/entry-server.js')).href)).render : undefined
+const mime = { '.js':'text/javascript', '.css':'text/css', '.svg':'image/svg+xml', '.png':'image/png', '.woff2':'font/woff2' }
+const server = createServer(async (req, res) => {
+  const pathname = new URL(req.url || '/', 'http://127.0.0.1').pathname
+  try {
+    if (pathname.startsWith('/api/')) {
+      const target = new URL(pathname, 'http://127.0.0.1:3030')
+      const body = req.method === 'GET' || req.method === 'HEAD' ? undefined : await (async () => { const chunks=[];for await(const chunk of req) { chunks.push(chunk); if(chunks.reduce((n,c)=>n+c.length,0)>65536) throw new Error('Request body too large') } return Buffer.concat(chunks) })()
+      const response = await fetch(target, { method: req.method, headers: { 'content-type': req.headers['content-type'] || 'application/json', accept: 'application/json' }, body })
+      res.writeHead(response.status, { 'content-type': response.headers.get('content-type') || 'application/json' })
+      res.end(Buffer.from(await response.arrayBuffer()));return
+    }
+    if (prod && pathname.startsWith('/assets/') && /^\/assets\/[a-zA-Z0-9._\/-]+$/.test(pathname)) {
+      const base = await realpath(resolve(root,'dist/client/assets'))
+      const pathnameOnDisk = resolve(root,'dist/client'+pathname)
+      if (!pathnameOnDisk.startsWith(base + sep)) {res.writeHead(403);res.end();return}
+      const bytes = await readFile(pathnameOnDisk)
+      res.writeHead(200,{'content-type': mime[extname(pathname)] || 'application/octet-stream'});res.end(bytes);return
+    }
+    if (pathname !== '/' && pathname !== '/about' && pathname !== '/about/') { res.writeHead(404);res.end('Not found');return }
+    const route = pathname.replace(/\/$/,'') || '/'
+    const page = prod ? html : await vite.transformIndexHtml(pathname, html)
+    const render = prod ? renderer : (await vite.ssrLoadModule('/src/entry-server.ts')).render
+    const content = await render(route)
+    res.writeHead(200,{'content-type':'text/html; charset=utf-8','cache-control':'no-store'})
+    res.end(page.replace('<!--app-html-->', content))
+  }
+  catch (error) { console.error('[ssr] request failed', error); if (!res.headersSent) res.writeHead(500);res.end('Internal server error') }
+})
+// Vite transforms assets in dev via its middleware, HTML is handled by our renderer.
+const app = createServer()
+app.on('request', (req,res) => {
+  if (vite && !new URL(req.url||'/', 'http://localhost').pathname.startsWith('/api/'))
+    vite.middlewares(req,res,()=>server.emit('request',req,res))
+  else server.emit('request',req,res)
+})
+app.listen(5173,'127.0.0.1',()=>console.log('SSR listening on http://127.0.0.1:5173'))
+process.on('SIGINT', () => { app.close(); void vite?.close() })

package/templates/daisyui-ssr/src/App.vue

@@ -0,0 +1,14 @@
+<script setup lang="ts">
+import NotesPanel from './components/NotesPanel.vue'
+defineProps<{ route: string }>()
+</script>
+<template>
+  <main class="min-h-screen bg-base-200 p-6"><div class="max-w-4xl mx-auto space-y-6">
+    <header class="navbar bg-base-100 rounded-box px-6 gap-4"><span class="font-bold">Feathers Console — daisyUI</span>
+      <a href="/" class="link">Accueil</a><a href="/about" class="link">À propos</a></header>
+    <h1 class="text-3xl font-semibold">{{ route === '/about' ? 'À propos de cet exemple' : 'Vue 3, Pinia et FeathersJS v5' }}</h1>
+    <p>Cette page publique ne contient aucune donnée personnelle. Les notes sont demandées au service Feathers après hydratation.</p>
+    <NotesPanel v-if="route !== '/about'" />
+    <p v-else>Rendu HTML public. API REST séparée et données de démonstration non prérendues.</p>
+  </div></main>
+</template>

package/templates/daisyui-ssr/src/components/NotesPanel.vue

@@ -0,0 +1,22 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref } from 'vue'
+import { useNotesStore } from '../stores/notes'
+const store = useNotesStore()
+const title = ref('')
+onMounted(() => { void store.load(); store.connectRealtime() })
+onUnmounted(() => store.disconnectRealtime())
+async function submit() { await store.create(title.value); if (!store.error) title.value = '' }
+</script>
+<template>
+  <section class="card bg-base-100 border border-base-300 shadow-lg"><div class="card-body">
+    <h2 class="card-title">Notes FeathersJS</h2>
+    <span class="badge badge-outline" data-testid="realtime-status">{{ store.realtimeConnected ? 'Temps réel connecté' : 'REST actif' }}</span>
+    <div v-if="store.error" class="alert alert-error" role="alert">{{ store.error }}</div>
+    <form class="flex gap-3 flex-wrap" @submit.prevent="submit">
+      <label class="input flex-1"><span class="label">Titre</span><input v-model="title" aria-label="Titre de la nouvelle note" maxlength="120" required /></label>
+      <button class="btn btn-primary" type="submit" :disabled="store.loading || !title.trim()">Créer une note</button>
+    </form>
+    <p data-testid="notes-count">{{ store.notes.length }} note(s)</p>
+    <ul data-testid="notes" class="list bg-base-200 rounded-box"><li v-for="note in store.notes" :key="note.id" class="list-row">{{ note.title }}</li></ul>
+  </div></section>
+</template>

package/templates/daisyui-ssr/src/entry-client.ts

@@ -0,0 +1,9 @@
+import { createApp, createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import App from './App.vue'
+import './style.css'
+const route = window.location.pathname.replace(/\/$/, '') || '/'
+// Static HTML in production is hydrated. A dev-only empty shell is mounted normally.
+const hydrated = Boolean(document.querySelector('#app')?.firstElementChild)
+const app = hydrated ? createSSRApp(App, { route }) : createApp(App, { route })
+app.use(createPinia()).mount('#app')

package/templates/daisyui-ssr/src/entry-server.ts

@@ -0,0 +1,9 @@
+import { createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import { renderToString } from 'vue/server-renderer'
+import App from './App.vue'
+export async function render(route: string): Promise<string> {
+  const app = createSSRApp(App, { route })
+  app.use(createPinia()) // fresh Pinia for every server-side render
+  return await renderToString(app)
+}

package/templates/daisyui-ssr/src/stores/notes.ts

@@ -0,0 +1,46 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import { io, type Socket } from 'socket.io-client'
+export interface Note { id: number; title: string }
+const realtime = import.meta.env.VITE_FEATHERS_REALTIME === '1'
+export const useNotesStore = defineStore('notes', () => {
+  const notes = ref<Note[]>([])
+  const loading = ref(false)
+  const error = ref('')
+  const realtimeConnected = ref(false)
+  let socket: Socket | undefined
+  async function load(): Promise<void> {
+    try {
+      const response = await fetch('/api/notes', { headers: { Accept: 'application/json' } })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      const payload: unknown = await response.json()
+      if (!Array.isArray(payload)) throw new Error('Unexpected notes response')
+      notes.value = payload as Note[]
+      error.value = ''
+    }
+    catch (cause) { error.value = cause instanceof Error ? cause.message : 'API unavailable' }
+  }
+  async function create(title: string): Promise<void> {
+    if (loading.value || !title.trim()) return
+    loading.value = true
+    try {
+      const response = await fetch('/api/notes', {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ title: title.trim() }),
+      })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      await load()
+    }
+    catch (cause) { error.value = cause instanceof Error ? cause.message : 'Create failed' }
+    finally { loading.value = false }
+  }
+  function connectRealtime(): void {
+    if (!realtime || typeof window === 'undefined' || socket) return
+    socket = io(window.location.origin, { path: '/socket.io', transports: ['websocket'] })
+    socket.on('connect', () => { realtimeConnected.value = true })
+    socket.on('disconnect', () => { realtimeConnected.value = false })
+    socket.on('notes created', () => { void load() })
+  }
+  function disconnectRealtime(): void { socket?.disconnect(); socket = undefined; realtimeConnected.value = false }
+  return { notes, loading, error, realtimeConnected, load, create, connectRealtime, disconnectRealtime }
+})

package/templates/daisyui-ssr/src/style.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+@plugin "daisyui";
+:root { font-family: ui-sans-serif, system-ui, sans-serif }

package/templates/daisyui-ssr/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/templates/daisyui-ssr/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "compilerOptions": { "target": "ES2022", "lib": ["ES2022", "DOM", "DOM.Iterable"], "module": "ESNext", "moduleResolution": "Bundler", "types": ["vite/client"], "strict": true, "exactOptionalPropertyTypes": true, "noUncheckedIndexedAccess": true, "isolatedModules": true, "skipLibCheck": true, "noEmit": true, "jsx": "preserve" },
+  "include": ["src/**/*.ts", "src/**/*.vue", "vite.config.ts"]
+}

package/templates/daisyui-ssr/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import tailwindcss from '@tailwindcss/vite'
+export default defineConfig({ plugins: [vue(), tailwindcss()],
+  server: { host: '127.0.0.1', port: 5173, strictPort: true, proxy: { '/api': 'http://127.0.0.1:3030' } },
+  appType: 'custom',
+})

package/templates/spa/common/.env.example

@@ -0,0 +1,7 @@
+# Local demonstration only. No secrets or private addresses.
+FEATHERS_ADAPTER=koa
+FEATHERS_API_PORT=3030
+FEATHERS_SOCKET_PORT=3031
+FEATHERS_SOCKETIO=0
+VITE_FEATHERS_REALTIME=0
+FEATHERS_PUBLIC_ORIGIN=http://127.0.0.1:5173