feat: favicon for all three apps + Prisma/SQLite in every scaffold

**Favicon**
- scripts/generate-favicon.mjs renders the header-logo artwork
  (accent-orange linear gradient, rounded square, 1px inner highlight)
  at 512×512 via puppeteer and writes favicon.svg + favicon.png into
  website/public, docs/public, examples/blog/public.
- Each root layout adds a <link rel="icon"> block (svg for capable
  browsers, png fallback, apple-touch-icon).
- Removed the old examples/blog/public/favicon.ico so everything uses
  the same brand artwork.

**Prisma/SQLite in every scaffold**
- packages/cli/lib/create.js now emits prisma/schema.prisma (SQLite
  provider + example User model) and lib/prisma.ts (singleton) for
  full-stack, api, and saas templates. Previously only saas got
  Prisma — api and full-stack had no DB story.
- package.json dependencies always include @prisma/client + prisma,
  and scripts expose `db:migrate`, `db:generate`, `db:studio`. `predev`
  runs `prisma generate`; `prestart` runs `prisma migrate deploy`.
- .env.example gets a DATABASE_URL line if it didn't already.
- .gitignore adds prisma/dev.db + dev.db-journal.
- SaaS template's own prisma files still overwrite the base after
  this block runs — its auth-centric schema wins for saas.
- packages/cli/templates/AGENTS.md adds a Database section explaining
  the Prisma workflow + scripts for scaffolded apps.

Author: vivek7405

docs/app/layout.ts

@@ -39,6 +39,9 @@ export function generateMetadata(ctx: { url: string }) {
 
 export default function RootLayout({ children }: { children: unknown }) {
   return html`
+    <link rel="icon" href="/public/favicon.svg" type="image/svg+xml">
+    <link rel="icon" href="/public/favicon.png" type="image/png">
+    <link rel="apple-touch-icon" href="/public/favicon.png">
     <script>
       (function(){
         try {

docs/public/favicon.png

@@ -60,6 +60,9 @@ export function generateMetadata(ctx: { url: string }) {
  */
 export default function RootLayout({ children }: { children: unknown }) {
   return html`
+    <link rel="icon" href="/public/favicon.svg" type="image/svg+xml">
+    <link rel="icon" href="/public/favicon.png" type="image/png">
+    <link rel="apple-touch-icon" href="/public/favicon.png">
     <script>
       (function(){
         try {

docs/public/favicon.svg

@@ -42,6 +42,7 @@ export async function scaffoldApp(name, cwd, opts = {}) {
     'modules',
     'lib',
     'public',
+    'prisma',
     'test/unit',
     'test/e2e',
   ];
@@ -55,26 +56,31 @@ export async function scaffoldApp(name, cwd, opts = {}) {
     type: 'module',
     private: true,
     scripts: {
+      predev: 'prisma generate',
+      prestart: 'prisma migrate deploy',
       dev: 'webjs dev',
       build: 'webjs build',
       start: 'webjs start',
       test: 'webjs test',
       'test:server': 'webjs test --server',
       'test:browser': 'webjs test --browser',
       check: 'webjs check',
+      'db:migrate': 'prisma migrate dev',
+      'db:generate': 'prisma generate',
+      'db:studio': 'prisma studio',
     },
     dependencies: {
+      '@prisma/client': '^6.0.0',
       '@webjskit/cli': 'latest',
       '@webjskit/core': 'latest',
       '@webjskit/server': 'latest',
-      ...(isSaas ? { '@prisma/client': '^6.0.0' } : {}),
     },
     devDependencies: {
       esbuild: '^0.28.0',
+      prisma: '^6.0.0',
       '@web/test-runner': '^0.20.0',
       '@web/test-runner-playwright': '^0.11.0',
       'playwright': '^1.59.0',
-      ...(isSaas ? { prisma: '^6.0.0' } : {}),
     },
   }, null, 2) + '\n');
 
@@ -140,6 +146,64 @@ export async function scaffoldApp(name, cwd, opts = {}) {
   const preCommitPath = join(appDir, '.hooks', 'pre-commit');
   if (existsSync(preCommitPath)) await chmod(preCommitPath, 0o755);
 
+  // --- Prisma schema + client singleton (all templates) ---
+
+  await writeFile(join(appDir, 'prisma', 'schema.prisma'), `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  // Defaults to SQLite at ./prisma/dev.db. Switch to postgresql / mysql
+  // by changing the provider + DATABASE_URL in .env.
+  provider = "sqlite"
+  url      = env("DATABASE_URL")
+}
+
+// Example model — feel free to delete or extend.
+model User {
+  id        Int      @id @default(autoincrement())
+  email     String   @unique
+  name      String?
+  createdAt DateTime @default(now())
+}
+`);
+
+  await writeFile(join(appDir, 'lib', 'prisma.ts'), `/**
+ * Prisma client singleton. The \`globalThis\` trick keeps a single
+ * instance across dev-server module reloads, so we don't open a new
+ * DB connection on every file change.
+ */
+import { PrismaClient } from '@prisma/client';
+
+const g = globalThis as unknown as { __prisma?: PrismaClient };
+
+export const prisma = g.__prisma ?? new PrismaClient();
+if (process.env.NODE_ENV !== 'production') g.__prisma = prisma;
+`);
+
+  // Env vars: append DATABASE_URL to the .env.example the template
+  // already copied (if present). The scaffold's root .env.example
+  // lists auth secrets etc.; we just add the DB line idempotently.
+  const envExample = join(appDir, '.env.example');
+  if (existsSync(envExample)) {
+    const cur = await readFile(envExample, 'utf8');
+    if (!cur.includes('DATABASE_URL')) {
+      await writeFile(envExample, cur.replace(/\n?$/, '\n') + '\nDATABASE_URL=file:./prisma/dev.db\n');
+    }
+  } else {
+    await writeFile(envExample, 'DATABASE_URL=file:./prisma/dev.db\n');
+  }
+
+  // .gitignore the generated SQLite file.
+  const gitignore = join(appDir, '.gitignore');
+  const gitignoreExtra = '\n# SQLite dev database\nprisma/dev.db\nprisma/dev.db-journal\n';
+  if (existsSync(gitignore)) {
+    const cur = await readFile(gitignore, 'utf8');
+    if (!cur.includes('prisma/dev.db')) await writeFile(gitignore, cur + gitignoreExtra);
+  } else {
+    await writeFile(gitignore, 'node_modules\n.webjs\n' + gitignoreExtra);
+  }
+
   // --- App files (template-specific) ---
 
   if (isApi) {

examples/blog/app/layout.ts

@@ -60,13 +60,49 @@ modules/<feature>/
   components/*.ts        feature-scoped components
   utils/*.ts             feature-scoped helpers
   types.ts               feature types
-lib/                     cross-cutting infra (prisma, session, auth config)
+lib/
+  prisma.ts              PrismaClient singleton (import from here, never `new PrismaClient()`)
+  ...                    other cross-cutting infra (session, auth config, etc.)
+prisma/
+  schema.prisma          Prisma schema — SQLite by default, switch provider for Postgres/MySQL
+  dev.db                 SQLite file (gitignored); run `npm run db:migrate` to create
+  migrations/            generated migration SQL
 public/                  static assets, served at /public/*
 test/unit/*.test.ts      unit tests (node --test)
 test/browser/*.test.ts   browser tests (web-test-runner)
 middleware.ts            root middleware (optional, outermost)
 ```
 
+## Database (Prisma + SQLite by default)
+
+Every scaffold includes a Prisma setup pointed at a local SQLite file.
+First-run workflow:
+
+```sh
+cp .env.example .env          # DATABASE_URL is pre-filled for SQLite
+npm run db:migrate            # creates prisma/dev.db + migration
+npm run dev                   # webjs dev + prisma generate via predev
+```
+
+Scripts:
+
+- `npm run db:migrate` — `prisma migrate dev` (dev-time schema changes + migration + generate)
+- `npm run db:generate` — `prisma generate` (regenerate client only)
+- `npm run db:studio` — `prisma studio` (GUI)
+- `predev` hook auto-runs `prisma generate` before `npm run dev`
+- `prestart` hook runs `prisma migrate deploy` before `npm start` (idempotent in prod)
+
+Always import the client from `lib/prisma.ts` (never `new PrismaClient()` directly —
+the singleton avoids opening a new connection on every dev-server reload):
+
+```ts
+import { prisma } from '../../../lib/prisma.ts';
+const users = await prisma.user.findMany();
+```
+
+To switch to Postgres or MySQL: change `provider` in `prisma/schema.prisma`
+and the `DATABASE_URL` in `.env`.
+
 ## Imports
 
 ```ts

examples/blog/public/favicon.ico

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Generates a single favicon.png (and matching SVG source) that mirrors
+ * the brand logo used in each app's header: a small rounded square with
+ * the accent-orange gradient + subtle inner highlight.
+ *
+ * Writes into website/public, docs/public, examples/blog/public.
+ *
+ *   node scripts/generate-favicon.mjs
+ */
+import puppeteer from 'puppeteer-core';
+import { writeFile } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, '..');
+
+const APPS = [
+  resolve(root, 'website/public'),
+  resolve(root, 'docs/public'),
+  resolve(root, 'examples/blog/public'),
+];
+
+// SVG that matches the header logo: linear gradient, rounded corners,
+// inner highlight ring. 512×512 so it down-scales cleanly to any size.
+const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="oklch(0.82 0.14 55)"/>
+      <stop offset="100%" stop-color="oklch(0.58 0.13 45)"/>
+    </linearGradient>
+  </defs>
+  <rect x="32" y="32" width="448" height="448" rx="96" ry="96" fill="url(#g)"/>
+  <rect x="32" y="32" width="448" height="448" rx="96" ry="96" fill="none" stroke="oklch(1 0 0 / 0.15)" stroke-width="6"/>
+</svg>`;
+
+const browser = await puppeteer.launch({
+  executablePath: process.env.CHROMIUM_PATH || '/usr/bin/chromium',
+  headless: true,
+  args: ['--no-sandbox', '--disable-setuid-sandbox'],
+});
+const page = await browser.newPage();
+await page.setViewport({ width: 512, height: 512, deviceScaleFactor: 1 });
+await page.setContent(`<!doctype html><html><body style="margin:0;background:transparent">${svg}</body></html>`, { waitUntil: 'load' });
+const png = await page.screenshot({ type: 'png', omitBackground: true });
+await browser.close();
+
+for (const pub of APPS) {
+  await writeFile(resolve(pub, 'favicon.svg'), svg);
+  await writeFile(resolve(pub, 'favicon.png'), png);
+  console.log('wrote', pub + '/favicon.{svg,png}', `(png: ${Math.round(png.length / 1024)} kB)`);
+}