wervt
Dashboard
API

Module

@wervt/nuxt options and what the module sets up.
nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@wervt/nuxt'],
  wervt: {
    app: 'todos', // defaults to the package.json name
    timezone: 'Europe/Berlin', // of nitro.scheduledTasks, UTC by default
    updates: 'banner', // or 'manual' or false, see Deploys > Open tabs
    webmcp: true, // false keeps server/tools/ away from browser agents, see Browser agents
    mcp: true, // false turns /mcp off; { title, description, instructions }, see MCP
    preview: { image: '/og.png' }, // link preview of a private app, see Private apps
    brand: true, // the login in the app's name, icon and color, see Login branding
    email: { theme: { accent: '#16a34a' } }, // the look of the app's own mails, see Email
    crossApp: ['/api/intake/'], // paths other apps' pages may post to, see Server routes
    services: { faces: { build: './face-service', port: 8000 } }, // containers, see Service containers
    database: true, // a database without drizzle/, for modules that create their own tables
    dev: {
      adminUrl: 'postgres://postgres:postgres@localhost:5432/wervt',
      dbSecret: 'dev-secret',
      electricUrl: 'http://localhost:3030',
      electricSecret: 'dev-electric-secret',
    },
  },
})

All options are optional; the defaults match the wervt compose.yml. The dev values can also come from WERVT_PG_ADMIN_URL, WERVT_DB_SECRET, ELECTRIC_URL and ELECTRIC_SECRET.

What it does

BuildSets the deno-server Nitro preset for production builds.
RuntimeInjects Buffer, setImmediate and clearImmediate from Node builtins, which Deno doesn't define globally.
ClientAuto-imports useShape, useWervtUser and useWervtUpdate.
UpdatesChecks for a new release every minute and when the tab comes back, then shows a reload banner (see Deploys).
DevCreates the app's role and schema, runs migrations (again when drizzle/ changes) and sets DATABASE_URL and the Electric env vars.
LogsSets up evlog: one wide event per request, useLogger(event) and log.
TasksTurns on Nitro tasks; production builds hand nitro.scheduledTasks to wervt (see Tasks).
FilesWith ablage installed, connects it to the app's bucket, in dev too (see Files).
ToolsRegisters server/tools/ with browser agents through WebMCP (see Browser agents).
MCPServes server/tools/ at /mcp, signed in through wervt's login (see App MCP).
IconsWith @nuxt/ui or @nuxt/icon, production builds don't let the server fall back to the Iconify API (the isolate can't reach it; @nuxt/icon bundles the locally installed collections on its own), and warn when no collection (for Nuxt UI: no Lucide, unless @iconify/json) is installed.
TypesTypes process.env in server code, for libraries that read it; app settings go through runtimeConfig (see Configuration and secrets).

Login branding

wervt's login (auth.dev.lightdrop.cloud) is shared by all apps, so by default it says wervt. With brand, it shows the app's own look whenever someone signs in to it: the login and consent pages, the account page opened from the app (/_wervt/account), the tab title and icon, and the code mails (sent as Lightdrop <mail@dev.lightdrop.cloud>). A small "Secured by wervt" stays by default, since the address bar shows wervt and the account works in other wervt apps too; securedByWervt: false removes it. The app's own mails (sendMail()) take over name, icon and color as well; email changes or turns that off, and sets their colors, fonts and frame (see Email).

nuxt.config.ts
wervt: {
  brand: {
    name: 'Lightdrop', // defaults to app.head.title up to its first separator
    logo: '/logo.svg', // wide logo on top of the login; without one, icon and name
    icon: '/icon.png', // tab and mail; PNG, since mail clients don't show SVG. Defaults to the PNG icon in app.head
    color: '#ff5a1f', // primary color, hex only; without it the login keeps wervt's
    securedByWervt: false, // hides "Secured by wervt" on the login and in the mail (shown by default)
    signIn: ['twitch', 'email'], // the sign-in options the login offers; all by default
    lang: 'de', // 'de' or 'en'; without it the login follows the visitor's browser
  },
}

true takes name and icon from app.head:

  • Name: the title up to its first separator (·, |, –, —, -, : ), so "Lightdrop · Drop it. Get it." signs in to "Lightdrop".
  • Icon: a PNG or JPEG icon or apple-touch-icon link if there is one, else the first icon. Gmail and Outlook don't show SVG, so an SVG favicon leaves the mail without an icon; the build warns about that.
  • Color: none. The theme-color meta tag is usually the page background, so set color for the login to use your accent.

Files are paths in public/ or https URLs. The runtime serves them to anyone at /_wervt/brand/…, private apps included, since the login needs them before anyone is signed in; nothing else of the app becomes public. Their URLs carry the release (?v=…), so a new logo shows right after the deploy despite long caching. Passkeys still show wervt in the browser's dialog: one passkey works for every app.

Signing in with Google, GitHub and the other providers goes through one OAuth app per instance, so their consent screens show its name and domain, not the app's. On a self-hosted server with one product, register that OAuth app under the product's name.

signIn picks from google, apple, microsoft, github, discord, twitch, spotify, passkey and email, for an app whose people all have the same kind of account (a streaming tool that only needs Twitch). The login always shows them in that order, and only the providers the server has keys for. If none of them is set up, it offers all options instead of none. It only shapes the page: the account stays a wervt account, and other apps still accept every option.

With email, the login offers "Sign in with email" and "Create an account" as two buttons, for private apps too: someone on the list who has no account yet creates one right there. An account alone opens nothing, the app's list (wervt access) still decides who gets in.

Language

The login, the consent page and the sign-in code mail speak English and German. lang pins one for the app. Without it (and for apps without brand) the login follows the browser's Accept-Language: German when German ranks above English and other languages, English otherwise. The code mail is in the language the page was shown in, so page and mail always match. Other values are dropped with a build warning, like an invalid color.

The mails @wervt/nuxt sends end users (InviteEmail and the frame of every WervtEmail) take a lang prop of their own; see Email. The dashboard, the CLI and log alert mails stay English.

Exports

Import
@wervt/nuxt/serveruseDb, proxyShape, validation helpers, useWervtUser, useWervtAccess, useLogger, log, defineTask, defineTool, defineToolRoute, useService, McpTokenContext (type of the wervt:mcp:token hook)
@wervt/nuxt/i18nLOCALES, negotiateLocale (Accept-Language to de/en), isLocale, defineMessages and translator for typed catalogs with {placeholders}, and mailMessages (the texts of the mail frame and InviteEmail)
@wervt/nuxt/provisionRe-exports @wervt/platform: provisionDatabase, setRoleTimeouts, appDatabaseUrl, dbRole, storageCredentials, createStorage (Node, used by the control plane and nuxt dev)
Copyright © 2026