Module
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
| Build | Sets the deno-server Nitro preset for production builds. |
| Runtime | Injects Buffer, setImmediate and clearImmediate from Node builtins, which Deno doesn't define globally. |
| Client | Auto-imports useShape, useWervtUser and useWervtUpdate. |
| Updates | Checks for a new release every minute and when the tab comes back, then shows a reload banner (see Deploys). |
| Dev | Creates the app's role and schema, runs migrations (again when drizzle/ changes) and sets DATABASE_URL and the Electric env vars. |
| Logs | Sets up evlog: one wide event per request, useLogger(event) and log. |
| Tasks | Turns on Nitro tasks; production builds hand nitro.scheduledTasks to wervt (see Tasks). |
| Files | With ablage installed, connects it to the app's bucket, in dev too (see Files). |
| Tools | Registers server/tools/ with browser agents through WebMCP (see Browser agents). |
| MCP | Serves server/tools/ at /mcp, signed in through wervt's login (see App MCP). |
| Icons | With @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. |
| Types | Types 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.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 <[email protected]>). 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).
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
iconorapple-touch-iconlink 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-colormeta tag is usually the page background, so setcolorfor 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/server | useDb, proxyShape, validation helpers, useWervtUser, useWervtAccess, useLogger, log, defineTask, defineTool, defineToolRoute, useService, McpTokenContext (type of the wervt:mcp:token hook) |
@wervt/nuxt/i18n | LOCALES, 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/provision | Re-exports @wervt/platform: provisionDatabase, setRoleTimeouts, appDatabaseUrl, dbRole, storageCredentials, createStorage (Node, used by the control plane and nuxt dev) |