create-volt 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to `create-volt` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.11.0] - 2026-06-28
+
+### Added
+- **`create-volt studio`** (and `npm run dev -- --studio`) — an ephemeral,
+  localhost-only **data browser**, à la Prisma Studio. Browse collections and
+  documents across any driver (memory / MongoDB / MySQL / Postgres) and delete
+  docs. It's **never a route in the running app** — it exists only while you run
+  it, binds `127.0.0.1`, and disappears on Ctrl-C (shell/SSH access is the auth).
+  Internal collections (auth tokens/sessions) are hidden.
+- Stores gained `collections()` (enumerate collection names) on every adapter.
+
+### Security
+- Admin/data surfaces are **ephemeral by design** — no standing `/admin` route in
+  the running app to attack (verified: the app 404s admin routes). Same model as
+  the config editor: on-demand, loopback-only, gone when the app runs.
+
+## [0.10.0] - 2026-06-28
+
+### Added
+- Frontend UI for the user-facing add-ons, auto-mounted when enabled:
+  - **auth** → a magic-link sign-in panel (email → link → signed-in state)
+  - **realtime** → a live chat panel (rooms, presence, typing, messages)
+  Each add-on serves its own `/<name>-ui.js` (only when enabled); `public/app.js`
+  mounts them alongside the demo. The server exposes `GET /__volt/addons`.
+
+### Security
+- Security headers on every response: `X-Content-Type-Options: nosniff`,
+  `X-Frame-Options: SAMEORIGIN`, `Referrer-Policy: same-origin`, `X-Powered-By` off.
+- Hardened forms: typed / length-capped / autocompleted inputs; all user content
+  renders through Volt holes (text nodes — HTML-escaped, no innerHTML); server
+  validation + caps (email ≤ 320, chat ≤ 500); `.env` values stripped of newlines;
+  session cookies `HttpOnly` + `SameSite=Lax`.
+
 ## [0.9.0] - 2026-06-28
 
 ### Changed
@@ -129,6 +162,8 @@ All notable changes to `create-volt` are documented here. The format follows
   watching and full-page hot reload. Supports `--skip-install` and `--force`,
   and auto-detects npm / pnpm / yarn / bun for the install step.
 
+[0.11.0]: https://github.com/MIR-2025/volt/releases/tag/v0.11.0
+[0.10.0]: https://github.com/MIR-2025/volt/releases/tag/v0.10.0
 [0.9.0]: https://github.com/MIR-2025/volt/releases/tag/v0.9.0
 [0.8.0]: https://github.com/MIR-2025/volt/releases/tag/v0.8.0
 [0.7.0]: https://github.com/MIR-2025/volt/releases/tag/v0.7.0

package/README.md

@@ -66,6 +66,19 @@ SSH-tunnel hint on a remote box). Enabling an add-on wires its **backend**
 automatically — the **frontend** UI (login form, chat) is yours to build, or
 start from `--template guestbook`, which has it wired end-to-end.
 
+## Studio (data browser)
+
+Browse your database on demand — ephemeral and localhost-only, like Prisma Studio:
+
+```bash
+npm run dev -- --studio    # or: npx create-volt studio
+```
+
+It connects the DB in your `.env`, lets you view/delete documents across any
+driver, and is **never** a route in the running app (no standing `/admin` to
+attack — shell/SSH access is the gate). Needs a persistent driver (MongoDB /
+MySQL / Postgres) to show data; the memory driver is per-process.
+
 ## Updating Volt
 
 Volt is vendored as a single file (`public/volt.js`), not an npm dependency.

package/addons/auth/files/lib/auth.js

@@ -72,7 +72,7 @@ export function authRouter({ store, mailer }) {
 
   router.post("/api/login", async (req, res) => {
     const email = normalize(req.body?.email);
-    if (!validEmail(email)) return res.status(400).json({ ok: false, error: "Enter a valid email." });
+    if (!validEmail(email) || email.length > 320) return res.status(400).json({ ok: false, error: "Enter a valid email." });
     const tok = token();
     await tokens.put(tok, { email, ua: req.headers["user-agent"] || "", expiresAt: Date.now() + TOKEN_TTL, used: false });
     const link = `${req.protocol}://${req.get("host")}/verify?token=${tok}`;

package/addons/auth/files/public/auth-ui.js

@@ -0,0 +1,62 @@
+// auth-ui.js — magic-link sign-in panel (frontend for the auth add-on).
+// Served at /auth-ui.js when auth is enabled; mounted by public/app.js.
+// All dynamic text is rendered through Volt holes, which create text nodes
+// (HTML-escaped) — so emails/notices can't inject markup.
+import { signal, html } from "/volt.js";
+
+const api = async (url, body) => {
+  const res = await fetch(url, {
+    method: body ? "POST" : "GET",
+    headers: body ? { "Content-Type": "application/json" } : undefined,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+  return res.json().catch(() => ({}));
+};
+
+// local part only, for a friendlier "signed in as" (still escaped on render)
+const shortName = (email) => String(email || "").split("@")[0];
+
+export function authPanel() {
+  const me = signal(null);
+  const email = signal("");
+  const notice = signal("");
+  const busy = signal(false);
+
+  api("/api/me").then((r) => me(r.email || null));
+
+  async function sendLink(e) {
+    e?.preventDefault?.();
+    const addr = email().trim();
+    if (!addr || busy()) return;
+    busy(true);
+    notice("Sending…");
+    const r = await api("/api/login", { email: addr });
+    busy(false);
+    notice(r.ok ? (r.dev ? "Magic link printed to the server console — open it to sign in." : `Magic link sent to ${addr}.`) : r.error || "Could not send link.");
+  }
+  async function logout() {
+    await api("/api/logout", {});
+    me(null);
+    notice("");
+  }
+
+  const signedOut = () =>
+    html`<form class="d-flex gap-2" onsubmit=${sendLink} autocomplete="on">
+      <input class="form-control" type="email" name="email" placeholder="you@example.com"
+             maxlength="320" autocomplete="email" inputmode="email" required
+             value=${email} oninput=${(e) => email(e.target.value)} />
+      <button class="btn btn-primary" type="submit" disabled=${() => busy()}>Send magic link</button>
+    </form>`;
+
+  const signedIn = () =>
+    html`<div class="d-flex justify-content-between align-items-center">
+      <span class="text-muted small">Signed in as <span class="accent fw-semibold">${() => shortName(me())}</span></span>
+      <button class="btn btn-sm btn-outline-secondary" onclick=${logout}>Sign out</button>
+    </div>`;
+
+  return html`<div class="card-x p-4 mb-4">
+    <h2 class="h6 mb-3">Account <span class="text-muted small">— magic-link auth</span></h2>
+    ${() => (me() ? signedIn() : signedOut())}
+    ${() => (notice() ? html`<p class="small text-muted mb-0 mt-2">${notice}</p>` : null)}
+  </div>`;
+}

package/addons/db/files/lib/stores/memory.js

@@ -29,5 +29,5 @@ export function createMemoryStore() {
     },
   });
 
-  return { name: "memory", async init() {}, collection };
+  return { name: "memory", async init() {}, collection, async collections() { return [...cols.keys()]; } };
 }

package/addons/db/files/lib/stores/mongo.js

@@ -39,5 +39,12 @@ export async function createMongoStore({ uri, dbName }) {
     };
   };
 
-  return { name: "mongodb", async init() {}, collection };
+  return {
+    name: "mongodb",
+    async init() {},
+    collection,
+    async collections() {
+      return (await db.listCollections().toArray()).map((c) => c.name);
+    },
+  };
 }

package/addons/db/files/lib/stores/sql.js

@@ -52,6 +52,9 @@ export async function createSqlStore({ dialect, uri }) {
          )`,
       );
     },
+    async collections() {
+      return (await run(`SELECT DISTINCT coll FROM documents`)).map((r) => r.coll);
+    },
     collection(n) {
       return {
         async put(id, doc) {

package/addons/db/files/public/db-admin-ui.js

@@ -0,0 +1,72 @@
+// db-admin-ui.js — a tiny, auth-gated data browser (frontend for the db add-on).
+// Served at /db-admin-ui.js; mounted by public/app.js only when db + auth are on.
+// Works for every driver — it reads through the generic store API on the server.
+// Documents render as escaped JSON text (Volt holes → text nodes), never HTML.
+import { signal, computed, html } from "/volt.js";
+
+const j = async (url, opts) => {
+  const res = await fetch(url, opts);
+  return { status: res.status, body: await res.json().catch(() => ({})) };
+};
+
+export function dbAdminPanel() {
+  const ready = signal(false); // signed in + loaded
+  const denied = signal(false); // 401
+  const driver = signal("");
+  const collections = signal([]);
+  const current = signal("");
+  const docs = signal([]);
+  const note = signal("");
+
+  async function loadCollections() {
+    const { status, body } = await j("/admin/db/collections");
+    if (status === 401) {
+      denied(true);
+      return;
+    }
+    denied(false);
+    driver(body.driver || "");
+    collections(body.collections || []);
+    ready(true);
+    if (!current() && collections().length) openCollection(collections()[0]);
+  }
+  async function openCollection(name) {
+    current(name);
+    note("");
+    const { body } = await j(`/admin/db/collection?name=${encodeURIComponent(name)}`);
+    docs(body.ok ? body.docs : []);
+  }
+  async function del(id) {
+    if (!id) return;
+    await j(`/admin/db/doc?name=${encodeURIComponent(current())}&id=${encodeURIComponent(id)}`, { method: "DELETE" });
+    docs(docs().filter((d) => d.id !== id));
+    note("Deleted.");
+  }
+
+  loadCollections();
+
+  const collTab = (name) =>
+    html`<button class=${() => "btn btn-sm " + (current() === name ? "btn-primary" : "btn-outline-secondary")} onclick=${() => openCollection(name)}>${name}</button>`;
+
+  const docRow = (d) =>
+    html`<div class="d-flex justify-content-between align-items-start gap-2 py-1" style="border-top:1px solid #232a36">
+      <pre class="mb-0 small flex-grow-1" style="white-space:pre-wrap;color:#cfe3ff">${JSON.stringify(d, null, 2)}</pre>
+      <button class="btn btn-sm btn-outline-danger" onclick=${() => del(d.id)}>✕</button>
+    </div>`;
+
+  const heading = computed(() => `Data ${driver() ? `— ${driver()}` : ""}`);
+
+  return html`<div class="card-x p-4 mb-4">
+    <h2 class="h6 mb-3">${heading} <span class="text-muted small">— admin</span></h2>
+    ${() =>
+      denied()
+        ? html`<p class="text-muted small mb-0">Sign in to browse your data.</p>`
+        : !ready()
+          ? html`<p class="text-muted small mb-0">Loading…</p>`
+          : html`<div class="d-flex flex-wrap gap-1 mb-2">${() => (collections().length ? collections().map(collTab) : html`<span class="text-muted small">No collections yet.</span>`)}</div>
+              <div style="max-height:260px;overflow:auto">
+                ${() => (docs().length ? docs().map(docRow) : html`<span class="text-muted small">Empty.</span>`)}
+              </div>
+              ${() => (note() ? html`<p class="small text-muted mb-0 mt-2">${note}</p>` : null)}`}
+  </div>`;
+}

package/addons/realtime/files/public/chat-ui.js

@@ -0,0 +1,116 @@
+// chat-ui.js — live chat panel (frontend for the realtime add-on). Served at
+// /chat-ui.js when realtime is enabled; mounted by public/app.js.
+// Identity comes from the auth session (if auth is on), else "guest-…".
+// All message text and names render through Volt holes → text nodes (escaped),
+// so nothing a user types can inject markup.
+import { signal, computed, html } from "/volt.js";
+import { createChat } from "/chat-client.js";
+
+const ROOMS = ["general", "random"];
+const MAX = 500; // keep in sync with the server cap
+
+const fmtTime = (ts) => {
+  try {
+    return new Date(ts).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+  } catch {
+    return "";
+  }
+};
+
+export function chatPanel() {
+  const room = signal(ROOMS[0]);
+  const messages = signal([]);
+  const online = signal([]);
+  const typers = signal([]);
+  const draft = signal("");
+
+  const timers = new Map();
+  const sawTyping = (name) => {
+    clearTimeout(timers.get(name));
+    if (!typers().includes(name)) typers([...typers(), name]);
+    timers.set(
+      name,
+      setTimeout(() => {
+        typers(typers().filter((n) => n !== name));
+        timers.delete(name);
+      }, 2500),
+    );
+  };
+
+  let chat;
+  try {
+    chat = createChat({
+      onHistory: ({ room: r, messages: m }) => {
+        if (r === room()) messages(m);
+      },
+      onMessage: (m) => {
+        if (m.room === room()) messages([...messages(), m]);
+      },
+      onPresence: ({ room: r, users }) => {
+        if (r === room()) online(users);
+      },
+      onTyping: ({ name }) => sawTyping(name),
+    });
+    chat.join(room());
+  } catch {
+    /* socket.io client missing — panel still renders, just inert */
+  }
+
+  const switchRoom = (r) => {
+    if (r === room() || !chat) return;
+    room(r);
+    messages([]);
+    online([]);
+    typers([]);
+    chat.join(r);
+  };
+
+  let lastTyped = 0;
+  const onType = (e) => {
+    draft(e.target.value);
+    const now = Date.now();
+    if (chat && now - lastTyped > 800) {
+      chat.typing(room());
+      lastTyped = now;
+    }
+  };
+  const send = () => {
+    const body = draft().trim();
+    if (!body || !chat) return;
+    chat.send(room(), body.slice(0, MAX));
+    draft("");
+  };
+
+  const typingLine = computed(() => {
+    const t = typers().filter((n) => n);
+    if (!t.length) return "";
+    return t.length === 1 ? `${t[0]} is typing…` : `${t.length} people are typing…`;
+  });
+
+  const roomTab = (r) =>
+    html`<button class=${() => "btn btn-sm " + (room() === r ? "btn-primary" : "btn-outline-secondary")} onclick=${() => switchRoom(r)}>#${r}</button>`;
+
+  const messageRow = (m) =>
+    html`<div class="py-1 small">
+      <span class="accent fw-semibold">${m.name}</span>
+      <span class="text-muted ms-1">${fmtTime(m.createdAt)}</span>
+      <div>${m.body}</div>
+    </div>`;
+
+  return html`<div class="card-x p-4 mb-4">
+    <div class="d-flex justify-content-between align-items-center mb-2">
+      <h2 class="h6 mb-0">Chat <span class="text-muted small">— realtime</span></h2>
+      <div class="d-flex gap-1">${ROOMS.map(roomTab)}</div>
+    </div>
+    <div class="small text-muted mb-2">Online: ${() => online().join(", ") || "—"}</div>
+    <div style="max-height:220px;overflow:auto">
+      ${() => (messages().length ? messages().map(messageRow) : html`<span class="text-muted small">No messages yet.</span>`)}
+    </div>
+    <div style="height:1.2em">${() => (typingLine() ? html`<span class="text-muted small fst-italic">${typingLine}</span>` : null)}</div>
+    <div class="input-group mt-2">
+      <input class="form-control" placeholder=${() => "Message #" + room() + "…"} maxlength=${String(MAX)}
+             value=${draft} oninput=${onType} onkeydown=${(e) => e.key === "Enter" && send()} />
+      <button class="btn btn-primary" onclick=${send}>Send</button>
+    </div>
+  </div>`;
+}

package/index.js

@@ -36,6 +36,7 @@ ${bold("Usage")}
   npx create-volt <project-directory> [options]
   npx create-volt@latest update              # refresh public/volt.js in an existing app
   npx create-volt@latest config              # open the app's setup wizard (edit add-ons + settings)
+  npx create-volt@latest studio              # browse your data — ephemeral, localhost (like Prisma Studio)
 
 ${bold("Options")}
   --template <name>  Starter template: default | guestbook  (default: default)
@@ -131,6 +132,21 @@ if (positionals[0] === "config") {
   process.exit(res.status ?? 0);
 }
 
+// --- `studio` subcommand: ephemeral, localhost-only data browser (server.js --studio) ---
+if (positionals[0] === "studio") {
+  const cwd = process.cwd();
+  if (!fs.existsSync(path.join(cwd, "server.js"))) {
+    die(`No ${cyan("server.js")} here — run ${cyan("create-volt studio")} from inside a Volt app.`);
+  }
+  if (portArg) process.env.PORT = String(Number(portArg) || "");
+  const res = spawnSync(process.execPath, ["server.js", "--studio"], {
+    cwd,
+    stdio: "inherit",
+    env: flags.has("--no-open") ? { ...process.env, VOLT_NO_OPEN: "1" } : process.env,
+  });
+  process.exit(res.status ?? 0);
+}
+
 // Resolve the dev port: --port wins, else derive it from today's date as
 // two-digit-year + month (no leading zero) + two-digit-day (house convention),
 // so apps scaffolded on different days don't collide on the same port.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-volt",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Scaffold a new Volt app — no-build, signals-based UI with Socket.io hot reload.",
   "type": "module",
   "bin": {

package/templates/default/public/app.js

@@ -63,4 +63,27 @@ function Todos() {
     </div>`;
 }
 
-mount("#app", Counter(), Todos());
+// Mount the demo, plus the UI for any enabled add-ons (auth, realtime, …).
+// Add-ons serve their own /…-ui.js when turned on in the setup wizard.
+const nodes = [Counter(), Todos()];
+let enabled = [];
+try {
+  enabled = await (await fetch("/__volt/addons")).json();
+} catch {
+  /* older app without the endpoint — just the demo */
+}
+if (enabled.includes("auth")) {
+  try {
+    nodes.unshift((await import("/auth-ui.js")).authPanel());
+  } catch {
+    /* auth UI unavailable */
+  }
+}
+if (enabled.includes("realtime")) {
+  try {
+    nodes.push((await import("/chat-ui.js")).chatPanel());
+  } catch {
+    /* realtime UI unavailable */
+  }
+}
+mount("#app", ...nodes);

package/templates/default/server.js

@@ -87,6 +87,13 @@ async function startApp() {
   const PORT = Number(process.env.PORT) || DEFAULT_PORT;
   const enabled = enabledFrom(process.env);
   const app = express();
+  app.disable("x-powered-by");
+  app.use((_req, res, next) => {
+    res.setHeader("X-Content-Type-Options", "nosniff");
+    res.setHeader("X-Frame-Options", "SAMEORIGIN");
+    res.setHeader("Referrer-Policy", "same-origin");
+    next();
+  });
   app.use(express.static(path.join(__dirname, "public")));
 
   let store = null;
@@ -95,6 +102,13 @@ async function startApp() {
   if (enabled.has("mailer")) mailer = await (await addonMod("mailer")).createMailer();
   if (enabled.has("auth") && store && mailer) app.use((await addonMod("auth")).authRouter({ store, mailer }));
 
+  // expose which add-ons are on, and serve each enabled add-on's frontend assets
+  app.get("/__volt/addons", (_req, res) => res.json([...enabled]));
+  for (const n of enabled) {
+    const pub = path.join(ADDONS_DIR, n, "files", "public");
+    if (fs.existsSync(pub)) app.use(express.static(pub));
+  }
+
   app.get("/", (_req, res) => res.sendFile(path.join(__dirname, "views", "index.html")));
 
   const server = http.createServer(app);
@@ -285,9 +299,95 @@ function readEnvFileLines() {
   return fs.existsSync(ENV_PATH) ? fs.readFileSync(ENV_PATH, "utf8").split("\n") : [];
 }
 
-// --- gate: setup on first run / --edit, otherwise the app ---
+// --- Studio: an ephemeral, localhost-only data browser (à la Prisma Studio).
+// Not a route in the running app — it only exists while you run `--studio`, on
+// loopback, and disappears on Ctrl-C. Shell/SSH access is the auth. ---
+const HIDDEN_COLLECTIONS = new Set(["auth_tokens", "auth_sessions", "__voltcheck"]);
+async function startStudio() {
+  loadEnv();
+  if (!enabledFrom(process.env).has("db")) {
+    console.error("Studio needs the db add-on. Enable it: npm run dev -- --edit");
+    process.exit(1);
+  }
+  let store;
+  try {
+    store = await (await addonMod("db")).createStore();
+  } catch (e) {
+    console.error("Studio: couldn't connect the store — " + e.message);
+    process.exit(1);
+  }
+  const PORT = Number(process.env.PORT) || Number(readEnvFile().PORT) || DEFAULT_PORT;
+  const visible = (n) => n && !HIDDEN_COLLECTIONS.has(n);
+  const assets = {
+    "/volt.js": ["text/javascript; charset=utf-8", fs.readFileSync(path.join(__dirname, "public", "volt.js"))],
+    "/db-admin-ui.js": ["text/javascript; charset=utf-8", fs.readFileSync(path.join(ADDONS_DIR, "db", "files", "public", "db-admin-ui.js"))],
+  };
+  const studioHtml = fs.readFileSync(path.join(__dirname, "setup", "studio.html"));
+  const json = (res, code, obj) => {
+    res.statusCode = code;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(obj));
+  };
+
+  const server = http.createServer(async (req, res) => {
+    const u = new URL(req.url, "http://localhost");
+    const p = u.pathname;
+    try {
+      if (req.method === "GET" && p === "/") {
+        res.setHeader("Content-Type", "text/html; charset=utf-8");
+        return res.end(studioHtml);
+      }
+      if (req.method === "GET" && assets[p]) {
+        res.setHeader("Content-Type", assets[p][0]);
+        return res.end(assets[p][1]);
+      }
+      if (req.method === "GET" && p === "/admin/db/collections") {
+        const all = (await store.collections()) || [];
+        return json(res, 200, { driver: store.name, collections: all.filter(visible) });
+      }
+      if (req.method === "GET" && p === "/admin/db/collection") {
+        const name = u.searchParams.get("name") || "";
+        if (!visible(name)) return json(res, 403, { ok: false, error: "hidden" });
+        const docs = (await store.collection(name).all()).slice(0, 500);
+        return json(res, 200, { ok: true, name, docs });
+      }
+      if (req.method === "DELETE" && p === "/admin/db/doc") {
+        const name = u.searchParams.get("name") || "";
+        const id = u.searchParams.get("id") || "";
+        if (!visible(name)) return json(res, 403, { ok: false, error: "hidden" });
+        if (!id) return json(res, 400, { ok: false, error: "missing id" });
+        await store.collection(name).delete(id);
+        return json(res, 200, { ok: true });
+      }
+      res.statusCode = 404;
+      res.end("not found");
+    } catch (e) {
+      json(res, 500, { ok: false, error: e.message });
+    }
+  });
+
+  server.listen(PORT, "127.0.0.1", () => {
+    const url = `http://localhost:${PORT}`;
+    console.log(`\n⚡ Volt Studio → ${url}   (${store.name})`);
+    console.log("  Browse your data. localhost-only, disposable — Ctrl-C when done.");
+    const ssh = process.env.SSH_CONNECTION;
+    if (ssh) {
+      const host = ssh.split(" ")[2];
+      const user = process.env.USER || process.env.USERNAME || "you";
+      console.log("  Remote box — from your LOCAL machine:");
+      console.log(`    ssh -N -L 127.0.0.1:${PORT}:localhost:${PORT} ${user}@${host}`);
+      console.log(`  …then open ${url}.`);
+    }
+    console.log("");
+    openBrowser(url);
+  });
+}
+
+// --- gate: studio / setup (first run, --edit) / the app ---
 const editMode = process.argv.includes("--edit") || process.argv.includes("-e");
-if (editMode || !fs.existsSync(ENV_PATH)) {
+if (process.argv.includes("--studio")) {
+  startStudio();
+} else if (editMode || !fs.existsSync(ENV_PATH)) {
   startSetup();
 } else {
   loadEnv();

package/templates/default/setup/setup.js

@@ -35,22 +35,23 @@ function effective(s) {
   return order.filter((n) => want.has(n));
 }
 
+const clean = (v) => String(v).replace(/[\r\n]/g, "").trim(); // one value per line; no injection
 function genEnv(s) {
   const eff = effective(s);
-  const out = [`VOLT_ADDONS=${eff.join(",")}`, `PORT=${s.port}`];
+  const out = [`VOLT_ADDONS=${eff.join(",")}`, `PORT=${clean(s.port)}`];
   if (eff.includes("db")) {
-    out.push(`DB_DRIVER=${s.dbDriver}`);
+    out.push(`DB_DRIVER=${clean(s.dbDriver)}`);
     if (s.dbDriver === "mongodb") {
-      out.push(`MONGODB_URI=${s.mongoUri}`);
-      if (s.mongoDb) out.push(`MONGODB_DATABASE=${s.mongoDb}`);
+      out.push(`MONGODB_URI=${clean(s.mongoUri)}`);
+      if (s.mongoDb) out.push(`MONGODB_DATABASE=${clean(s.mongoDb)}`);
     } else if (s.dbDriver === "mysql" || s.dbDriver === "postgres") {
-      out.push(`DATABASE_URL=${s.dbUrl}`);
+      out.push(`DATABASE_URL=${clean(s.dbUrl)}`);
     }
   }
   if (eff.includes("mailer")) {
-    if (s.smtpUrl) out.push(`SMTP_URL=${s.smtpUrl}`);
+    if (s.smtpUrl) out.push(`SMTP_URL=${clean(s.smtpUrl)}`);
     else out.push("# SMTP_URL=        # unset → emails print to the console");
-    if (s.mailFrom) out.push(`MAIL_FROM=${s.mailFrom}`);
+    if (s.mailFrom) out.push(`MAIL_FROM=${clean(s.mailFrom)}`);
   }
   return out.join("\n") + "\n";
 }

package/templates/default/setup/studio.html

@@ -0,0 +1,28 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Volt Studio</title>
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
+  <style>
+    body { background: #0f1115; color: #e7e9ee; }
+    .accent { color: #ffd24a; }
+    .card-x { background: #161a22; border: 1px solid #232a36; border-radius: 14px; }
+  </style>
+</head>
+<body>
+  <main class="container py-5" style="max-width: 820px;">
+    <header class="mb-4">
+      <h1 class="h3"><span class="accent">⚡ Volt Studio</span> <small class="text-muted">data browser</small></h1>
+      <p class="text-muted mb-0">Browse the database in your <code>.env</code>. Disposable &amp; localhost-only — close the terminal when done.</p>
+    </header>
+    <div id="app"></div>
+  </main>
+  <script type="module">
+    import { mount } from "/volt.js";
+    import { dbAdminPanel } from "/db-admin-ui.js";
+    mount("#app", dbAdminPanel());
+  </script>
+</body>
+</html>