Developer Documentation

VeloCMS developer reference.

Reference documentation for the plugin SDK, manifest format, and hook API behind VeloCMS's own first-party integrations. TypeScript-first and Zod-validated, with a capability manifest on every plugin.

Third-party plugin and theme development isn't open yet.

These docs describe the SDK, manifest and theme contract behind VeloCMS's own first-party plugins and themes. VeloCMS is a hosted platform, so nothing built from them can be installed on a VeloCMS site, and submitting or selling a plugin or theme as an outside developer isn't something you can do today. There's no date for that to change. See Marketplace Policies for what's live now.

Getting Started

Scaffold a plugin project with the public CLI and run its unit tests locally. Reference material for now: plugins and themes from outside developers can't be installed on VeloCMS yet.

Plugin Development

Lifecycle hooks, capability declarations, settings UI integration, and the full testing workflow.

Security Guidelines

What plugins can and cannot do, capability enforcement, network allowlists, and secret handling.

Marketplace Policies

Where third-party code can run, the security boundary between apps and plugins, and how to request an integration.

API Reference

Hook payload types, manifest schema, capabilities reference, and the @velocms/cli command reference.

Community

How to reach the VeloCMS team about an integration request, a bug, or a security report.

Public npm packages

Published so the types, test helpers, and scaffolders can be read and tried. A plugin or theme built with them can't be installed on a VeloCMS site today.

create-velocms-pluginInteractive plugin scaffolder
create-velocms-themeInteractive theme scaffolder
@velocms/clidev / test / build command-line tooling
@velocms/plugin-typesTypeScript types for plugin development