Search documentation...

CLI Reference

Complete reference for Velt command-line interface.

Commands

`velt new <

name>`

Create a new Velt project.

./velt new my-website

Creates a new directory with:

  • content/index.vdx - Sample page
  • layouts/default.v - Default layout
  • components/callout.v - Sample component
  • assets/style.css - Base styles

velt dev

Start the development server.

./velt dev

Options:

  • Default port: 3000
  • Live reload enabled
  • Watches content/ for changes

The dev server automatically rebuilds when you save changes.

velt build

Build the site for production.

./velt build

Generates static HTML files in dist/ directory.

velt serve

Start a simple HTTP server for the built site.

./velt serve

Serves the dist/ directory without live reload.

Environment Variables

Variable Description Default
V_EXE Path to V compiler v

Exit Codes

Code Description
0 Success
1 Error (see output)

Examples

# Create and develop
./velt new blog
cd blog
../velt dev

# Build for deployment
../velt build