create-noy-db 0.1.0-pre.4

package/templates/electron/src/components/InvoiceTable.vue

@@ -0,0 +1,41 @@
+<script setup lang="ts">
+import type { Invoice } from '../stores/invoices'
+
+defineProps<{ invoices: Invoice[] }>()
+const emit = defineEmits<{ (e: 'remove', id: string): void }>()
+</script>
+
+<template>
+  <section class="invoices">
+    <h2>Invoices</h2>
+    <table v-if="invoices.length > 0">
+      <thead>
+        <tr>
+          <th>ID</th>
+          <th>Client</th>
+          <th>Amount</th>
+          <th>Status</th>
+          <th>Issued</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr v-for="inv in invoices" :key="inv.id">
+          <td>{{ inv.id }}</td>
+          <td>{{ inv.client }}</td>
+          <td>{{ inv.amount.toLocaleString() }}</td>
+          <td>
+            <span :class="`status-pill status-${inv.status}`">{{ inv.status }}</span>
+          </td>
+          <td>{{ inv.issueDate }}</td>
+          <td>
+            <button class="danger" @click="emit('remove', inv.id)">×</button>
+          </td>
+        </tr>
+      </tbody>
+    </table>
+    <p v-else class="empty">
+      No invoices yet — add one above.
+    </p>
+  </section>
+</template>

package/templates/electron/src/main.ts

@@ -0,0 +1,48 @@
+/**
+ * {{PROJECT_NAME}} — renderer bootstrap.
+ *
+ * Opens a Noydb vault backed by `@noy-db/to-file`, writing JSON to
+ * a directory under the user's data folder. Perfect for the
+ * USB-stick workflow: point the `dir` at an external mount and
+ * the vault travels with you.
+ */
+
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import { createNoydb } from '@noy-db/hub'
+import { jsonFile } from '@noy-db/to-file'
+import { setActiveNoydb } from '@noy-db/in-pinia'
+import path from 'node:path'
+import App from './App.vue'
+import './style.css'
+
+async function bootstrap(): Promise<void> {
+  const pinia = createPinia()
+
+  // Default directory: `<userData>/{{PROJECT_NAME}}/vault`. For a
+  // USB-stick workflow, prompt the user for a path and use that
+  // instead (e.g. `/Volumes/USB/myapp`).
+  const baseDir = process.env.VITE_DEV_SERVER_URL
+    ? path.resolve('./.{{PROJECT_NAME}}-dev-vault')
+    : path.resolve(process.resourcesPath ?? '.', '{{PROJECT_NAME}}-vault')
+
+  const passphrase = prompt(
+    'Enter passphrase for {{PROJECT_NAME}}\n\n' +
+      'Master encryption key — lose it and the data is unrecoverable.',
+  ) ?? ''
+  if (passphrase.length === 0) {
+    document.body.textContent = 'Cancelled — reload to try again.'
+    return
+  }
+
+  const db = await createNoydb({
+    store: jsonFile({ dir: baseDir }),
+    user: 'owner',
+    secret: passphrase,
+  })
+  await db.openVault('demo')
+  setActiveNoydb(db)
+  createApp(App).use(pinia).mount('#app')
+}
+
+void bootstrap()

package/templates/electron/src/stores/invoices.ts

@@ -0,0 +1,35 @@
+/**
+ * Invoice store — reactive, encrypted, backed by a noy-db collection.
+ *
+ * `defineNoydbStore` wraps `defineStore` from Pinia and wires the
+ * store to a vault + collection. All writes encrypt before the
+ * IndexedDB adapter sees them; all reads decrypt into the reactive
+ * `items` array.
+ *
+ * Use from components:
+ *   const invoices = useInvoices()
+ *   await invoices.$ready
+ *   await invoices.add(id, record)
+ *   invoices.items   // reactive array
+ *   invoices.count   // reactive getter
+ */
+import { defineNoydbStore } from '@noy-db/in-pinia'
+
+export interface Invoice {
+  id: string
+  client: string
+  amount: number
+  status: 'draft' | 'open' | 'paid' | 'overdue'
+  issueDate: string // ISO-8601
+}
+
+export const useInvoices = defineNoydbStore<Invoice>('invoices', {
+  vault: 'demo',
+})
+
+/** Optional seed set rendered on first load when the collection is empty. */
+export const DEFAULT_INVOICES: Invoice[] = [
+  { id: 'inv-001', client: 'Acme Corp', amount: 1_200, status: 'paid', issueDate: '2026-01-15' },
+  { id: 'inv-002', client: 'Globex', amount: 2_400, status: 'open', issueDate: '2026-02-01' },
+  { id: 'inv-003', client: 'Initech', amount: 800, status: 'draft', issueDate: '2026-02-20' },
+]

package/templates/electron/src/style.css

@@ -0,0 +1,119 @@
+:root {
+  color-scheme: light;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  color: #1f2937;
+  background: #f9fafb;
+}
+
+* { box-sizing: border-box; }
+
+body { margin: 0; padding: 1rem; }
+
+.app { max-width: 900px; margin: 0 auto; }
+
+header {
+  border-bottom: 1px solid #e5e7eb;
+  padding-bottom: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+h1 { font-size: 1.5rem; margin: 0 0 0.5rem 0; }
+
+.subtitle { color: #6b7280; font-size: 0.9rem; margin: 0; }
+
+.loading {
+  background: white;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.5rem;
+  padding: 1.5rem;
+  text-align: center;
+  color: #6b7280;
+}
+
+.summary {
+  display: flex;
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+
+.stat {
+  flex: 1;
+  background: white;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.5rem;
+  padding: 1rem;
+}
+.stat .label { color: #6b7280; font-size: 0.75rem; text-transform: uppercase; }
+.stat .value { font-size: 1.5rem; font-weight: 600; margin-top: 0.25rem; }
+
+.add-form {
+  display: flex;
+  gap: 0.5rem;
+  margin-bottom: 1.5rem;
+}
+.add-form input, .add-form select {
+  padding: 0.5rem;
+  border: 1px solid #d1d5db;
+  border-radius: 0.25rem;
+  font-size: 0.875rem;
+}
+.add-form input[placeholder='Client name'] { flex: 2; }
+.add-form input[type='number'] { flex: 1; }
+
+button {
+  padding: 0.5rem 1rem;
+  border: 1px solid #2563eb;
+  background: #2563eb;
+  color: white;
+  border-radius: 0.25rem;
+  cursor: pointer;
+  font-size: 0.875rem;
+}
+button:hover { background: #1d4ed8; }
+button.danger {
+  background: #dc2626;
+  border-color: #dc2626;
+  padding: 0.125rem 0.5rem;
+}
+
+.invoices h2 { font-size: 1.1rem; margin-top: 0; }
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  background: white;
+  border: 1px solid #e5e7eb;
+  border-radius: 0.5rem;
+  overflow: hidden;
+}
+th, td {
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+  border-bottom: 1px solid #e5e7eb;
+  font-size: 0.875rem;
+}
+th { background: #f3f4f6; font-weight: 600; }
+tr:last-child td { border-bottom: 0; }
+
+.empty { color: #6b7280; text-align: center; font-style: italic; padding: 1rem; }
+
+.status-pill {
+  display: inline-block;
+  padding: 0.125rem 0.5rem;
+  border-radius: 0.25rem;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  font-weight: 600;
+}
+.status-draft    { background: #f3f4f6; color: #4b5563; }
+.status-open     { background: #dbeafe; color: #1e40af; }
+.status-paid     { background: #d1fae5; color: #065f46; }
+.status-overdue  { background: #fee2e2; color: #b91c1c; }
+
+footer {
+  margin-top: 3rem;
+  padding-top: 1rem;
+  border-top: 1px solid #e5e7eb;
+  color: #6b7280;
+  font-size: 0.85rem;
+}

package/templates/electron/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true,
+    "useDefineForClassFields": true,
+    "jsx": "preserve",
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.vue", "electron/**/*.ts"]
+}

package/templates/electron/vite.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import electron from 'vite-plugin-electron'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    electron({
+      entry: 'electron/main.ts',
+      vite: {
+        build: {
+          outDir: 'dist-electron',
+          target: 'es2022',
+        },
+      },
+    }),
+  ],
+  build: {
+    target: 'es2022',
+  },
+})

package/templates/nuxt-default/README.md

@@ -0,0 +1,38 @@
+# {{PROJECT_NAME}}
+
+A Nuxt 4 + Pinia + [noy-db](https://github.com/vLannaAi/noy-db) starter, scaffolded by `create-noy-db`.
+
+## Stack
+
+- **Nuxt 4** — fullstack Vue framework
+- **Pinia** — reactive state management
+- **@noy-db/in-nuxt** — Nuxt module for noy-db (auto-imports, SSR-safe runtime, devtools tab)
+- **@noy-db/in-pinia** — `defineNoydbStore` — drop-in `defineStore` replacement that wires a Pinia store to an encrypted compartment + collection
+- **@noy-db/{{ADAPTER}}** — storage adapter
+
+Everything stored is encrypted with AES-256-GCM before it touches the adapter. The adapter only ever sees ciphertext.
+
+## Getting started
+
+```bash
+pnpm install     # or npm/yarn/bun
+pnpm dev         # nuxt dev on http://localhost:3000
+pnpm build       # production build
+pnpm preview     # preview the production build
+pnpm verify      # run the noy-db integrity check
+```
+
+## Adding a collection
+
+```bash
+npx noy-db add clients
+```
+
+This scaffolds `app/stores/clients.ts` and `app/pages/clients.vue`. Edit the generated `Client` interface to match your domain, then visit `/clients` in your dev server.
+
+## Documentation
+
+- [noy-db getting started](https://github.com/vLannaAi/noy-db/blob/main/docs/quickstart.md)
+- [End-user features](https://github.com/vLannaAi/noy-db/blob/main/docs/features.md)
+- [Architecture](https://github.com/vLannaAi/noy-db/blob/main/docs/architecture.md)
+- [Roadmap](https://github.com/vLannaAi/noy-db/blob/main/ROADMAP.md)

package/templates/nuxt-default/_gitignore

@@ -0,0 +1,32 @@
+# Nuxt build outputs
+.nuxt
+.output
+.data
+.cache
+.vite
+
+# Node
+node_modules
+*.log
+.npm
+
+# Env files
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/*
+!.vscode/extensions.json
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+
+# Test coverage
+coverage

package/templates/nuxt-default/app/app.vue

@@ -0,0 +1,37 @@
+<script setup lang="ts">
+// Top-level layout. Add navigation here as you grow the app.
+</script>
+
+<template>
+  <div>
+    <header>
+      <nav>
+        <NuxtLink to="/">Home</NuxtLink>
+        <NuxtLink to="/invoices">Invoices</NuxtLink>
+      </nav>
+    </header>
+    <main>
+      <NuxtPage />
+    </main>
+  </div>
+</template>
+
+<style>
+nav {
+  display: flex;
+  gap: 1rem;
+  padding: 1rem;
+  border-bottom: 1px solid #e5e5e5;
+}
+nav a {
+  text-decoration: none;
+  color: #0070f3;
+}
+nav a.router-link-active {
+  font-weight: bold;
+}
+main {
+  padding: 1rem;
+  font-family: system-ui, sans-serif;
+}
+</style>

package/templates/nuxt-default/app/pages/index.vue

@@ -0,0 +1,21 @@
+<script setup lang="ts">
+// Landing page for the generated noy-db app.
+</script>
+
+<template>
+  <section>
+    <h1>{{PROJECT_NAME}}</h1>
+    <p>
+      Encrypted, offline-first, zero-knowledge document store powered by
+      <a href="https://github.com/vLannaAi/noy-db">noy-db</a>.
+    </p>
+    <p>
+      Visit <NuxtLink to="/invoices">/invoices</NuxtLink> to see the demo
+      invoices store.
+    </p>
+    <p>
+      Run <code>noy-db verify</code> at any time to check the integrity of
+      your noy-db install.
+    </p>
+  </section>
+</template>

package/templates/nuxt-default/app/pages/invoices.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+import { DEFAULT_INVOICES } from '~/stores/invoices'
+
+const invoices = useInvoices()
+await invoices.$ready
+
+// Seed on first run: if the store is empty and there are defaults, populate.
+// This runs once on component mount; later visits see whatever the user
+// has edited.
+if (invoices.items.length === 0 && DEFAULT_INVOICES.length > 0) {
+  for (const inv of DEFAULT_INVOICES) {
+    invoices.add(inv)
+  }
+}
+
+// Reactive query: re-runs whenever the underlying collection changes.
+const open = invoices.query()
+  .where('status', '==', 'open')
+  .live()
+
+function addDraft() {
+  invoices.add({
+    id: crypto.randomUUID(),
+    client: 'New Client',
+    amount: Math.round(Math.random() * 10000),
+    status: 'draft',
+    dueDate: new Date().toISOString().slice(0, 10),
+  })
+}
+
+function remove(id: string) {
+  invoices.remove(id)
+}
+</script>
+
+<template>
+  <section>
+    <h1>Invoices</h1>
+    <button @click="addDraft">+ New draft</button>
+    <p><strong>{{ open.length }}</strong> open invoice(s)</p>
+    <ul>
+      <li v-for="inv in invoices.items" :key="inv.id">
+        <strong>{{ inv.client }}</strong> — {{ inv.amount }} ({{ inv.status }})
+        <button @click="remove(inv.id)">Delete</button>
+      </li>
+    </ul>
+    <p v-if="invoices.items.length === 0">
+      No invoices yet — click "New draft" to add one.
+    </p>
+  </section>
+</template>
+
+<style scoped>
+button {
+  cursor: pointer;
+  padding: 0.25rem 0.75rem;
+  margin: 0.25rem;
+}
+li {
+  padding: 0.5rem 0;
+}
+</style>

package/templates/nuxt-default/app/stores/invoices.ts

@@ -0,0 +1,23 @@
+// Generated by `create-noy-db`.
+//
+// `defineNoydbStore` is auto-imported by @noy-db/in-nuxt. The store wires
+// a Pinia store to a noy-db compartment + collection. Encryption,
+// keyring management, and adapter wiring are invisible to components.
+
+export interface Invoice {
+  id: string
+  client: string
+  amount: number
+  status: 'draft' | 'open' | 'paid' | 'overdue'
+  dueDate: string
+}
+
+export const useInvoices = defineNoydbStore<Invoice>('invoices', {
+  vault: 'demo-co',
+})
+
+/**
+ * Default seed records rendered into the store on first mount (see
+ * `app/pages/invoices.vue`). An empty array means the page starts empty.
+ */
+export const DEFAULT_INVOICES: Invoice[] = {{SEED_INVOICES}}

package/templates/nuxt-default/nuxt.config.ts

@@ -0,0 +1,30 @@
+// Generated by `create-noy-db`.
+//
+// The `noydb:` key is fully typed via @noy-db/in-nuxt's module augmentation
+// of @nuxt/schema. Hover any field for documentation.
+
+export default defineNuxtConfig({
+  compatibilityDate: '2026-04-01',
+
+  modules: [
+    '@pinia/nuxt',
+    '@noy-db/in-nuxt',
+  ],
+
+  noydb: {
+    adapter: '{{ADAPTER}}',
+    pinia: true,
+    devtools: {{DEVTOOLS}},
+  },
+
+  devtools: {
+    enabled: process.env['NODE_ENV'] !== 'production',
+  },
+
+  telemetry: false,
+
+  typescript: {
+    strict: true,
+    typeCheck: false,
+  },
+})

package/templates/nuxt-default/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "preview": "nuxt preview",
+    "verify": "noy-db verify"
+  },
+  "dependencies": {
+    "@noy-db/to-browser-idb": "^0.11.0",
+    "@noy-db/hub": "^0.11.0",
+    "@noy-db/to-file": "^0.11.0",
+    "@noy-db/to-memory": "^0.11.0",
+    "@noy-db/in-nuxt": "^0.11.0",
+    "@noy-db/in-pinia": "^0.11.0",
+    "@noy-db/in-vue": "^0.11.0",
+    "@pinia/nuxt": "^0.11.0",
+    "nuxt": "^4.4.2",
+    "pinia": "^3.0.1",
+    "vue": "^3.5.32"
+  },
+  "devDependencies": {
+    "create-noy-db": "^0.5.0"
+  }
+}

package/templates/nuxt-default/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./.nuxt/tsconfig.json"
+}

package/templates/vanilla/README.md

@@ -0,0 +1,77 @@
+# {{PROJECT_NAME}}
+
+A Vite + TypeScript + [noy-db](https://github.com/vLannaAi/noy-db)
+starter with **no framework** — just the browser, the hub, and the
+IndexedDB store. Scaffolded by `create-noy-db`.
+
+## Stack
+
+- **Vite** — dev server + build
+- **@noy-db/hub** — zero-knowledge encrypted document store
+- **@noy-db/to-browser-idb** — IndexedDB adapter (atomic CAS, larger
+  quota than localStorage)
+
+Everything stored is encrypted with AES-256-GCM before it touches
+IndexedDB. The adapter only ever sees ciphertext.
+
+## When to pick this template
+
+- You want the **smallest possible** noy-db starting point.
+- You're integrating noy-db into an existing non-framework app (hand-rolled
+  DOM, web components, a library).
+- You want to learn the hub API without a framework abstraction layer in
+  the way.
+
+If you want Vue, Pinia, or Nuxt, pick the `nuxt-default` template
+instead (`npm create noy-db@latest -- --template nuxt-default`).
+
+## Getting started
+
+```bash
+pnpm install     # or npm/yarn/bun
+pnpm dev         # vite dev on http://localhost:5173
+pnpm build       # production build
+pnpm preview     # preview the production build
+pnpm verify      # run the noy-db integrity check
+```
+
+First time the page loads it will prompt for a **passphrase** — that
+passphrase derives the master key. Lose it and the data is
+unrecoverable (by design: the library cannot help you).
+
+## What's in `src/main.ts`
+
+The starter walks through the full lifecycle:
+
+1. `createNoydb({ store: browserIdbStore(), secret: passphrase })` —
+   open the encrypted store.
+2. `await db.openVault('demo')` — create or open a vault (tenant).
+3. `vault.collection<Invoice>('invoices')` — typed collection.
+4. CRUD operations — `.put()` / `.get()` / `.delete()` / `.list()`.
+5. `db.close()` — clears the master key from memory.
+
+The UI is intentionally plain HTML — swap in your framework of choice
+once you've understood the flow.
+
+## Verifying zero-knowledge
+
+Open DevTools → Application → IndexedDB → your origin → `noydb_demo`
+(or whatever vault name you used). Every record shows `{ _noydb: 1,
+_v, _ts, _iv, _data }`. The `_data` blob is AES-GCM ciphertext — the
+literal record contents never appear.
+
+## Adding a collection
+
+```bash
+npx noy-db add clients
+```
+
+This scaffolds `src/clients.ts` with a typed Client interface +
+CRUD helpers. Edit the generated interface to match your domain.
+
+## Documentation
+
+- [noy-db getting started](https://github.com/vLannaAi/noy-db/blob/main/docs/quickstart.md)
+- [Topology matrix](https://github.com/vLannaAi/noy-db/blob/main/docs/topologies.md) — pick the right stack
+- [Architecture](https://github.com/vLannaAi/noy-db/blob/main/docs/architecture.md)
+- [Roadmap](https://github.com/vLannaAi/noy-db/blob/main/ROADMAP.md)

package/templates/vanilla/_gitignore

@@ -0,0 +1,29 @@
+# Vite / build output
+dist
+.vite
+
+# Node
+node_modules
+*.log
+.npm
+
+# Env files
+.env
+.env.local
+.env.*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/*
+!.vscode/extensions.json
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+
+# Test coverage
+coverage