Skip to main content
Extensions are factories that add focused capabilities to a Veryfront project: a cache store, an auth provider, a database adapter, a model provider, or an MDX content pipeline. For the concepts behind factories, contracts, capabilities, setup, and teardown, see Framework extensions.

​
Prerequisites

  • A Veryfront project with veryfront.config.ts.
  • For a first-party extension: the matching package installed.
  • For a local extension: a folder under extensions/ with a default-exported factory (see Extension authoring).

​
Enable an extension

Add extension factories to veryfront.config.ts: 
import { defineConfig } from "veryfront";
import extRedis from "@veryfront/ext-cache-redis";

export default defineConfig({
  extensions: [
    extRedis({ url: "redis://localhost:6379", prefix: "myapp:" }),
  ],
});
Use a local extension the same way: 
import { defineConfig } from "veryfront";
import memoryCache from "./extensions/memory-cache/src/index.ts";

export default defineConfig({
  extensions: [
    memoryCache({ maxSize: 500 }),
  ],
});
Verify the extension loads by running the dev server: 
veryfront dev
If the extension factory throws during setup, the dev server reports the setup error. For local extensions, edit the extension source and save veryfront.config.ts to force reload during development.

​
First-party extension areas

AreaExample packageContract family
Auth@veryfront/ext-auth-jwtAuthProvider
Cache@veryfront/ext-cache-redisCacheStore
Content@veryfront/ext-content-mdxcontent parsing
CSS@veryfront/ext-css-tailwindCSS processing
Database@veryfront/ext-db-sqlitedatabase access
LLM@veryfront/ext-llm-openaimodel providers
Observability@veryfront/ext-observability-opentelemetrytelemetry
Parser@veryfront/ext-parser-babelparsing
Sandbox@veryfront/ext-sandbox-shell-toolssandbox tools
Schema@veryfront/ext-schema-zodschema validation

​
Verify it worked

Restart veryfront dev after editing veryfront.config.ts:
  • The dev log should print a setup line for each loaded extension.
  • Any contract the extension provides should now be resolvable through the matching consumer (for example, a CacheStore extension lets cache-aware code skip its local fallback).
  • If the factory throws during setup, the dev server prints the setup error with the extension name. Fix the error and reload.