Veltro Theme Documentation

Installation Guide

Veltro requires Node.js 22.12.0 or later, as declared in package.json. The project uses npm and includes a package-lock.json.

Tip

Use the scripts in package.json. The development and build scripts regenerate the JSON config that Astro imports.

Install Node.js

Windows

Install Node.js from nodejs.org, then verify it:

node -v

macOS

Install Node.js with Homebrew or the official installer:

brew install node
node -v

Linux

Install Node.js with your preferred package manager or the official installer, then verify it:

node -v

Install Dependencies

From the veltro/ project directory:

npm install

Start Development

npm run dev

This starts the TOML watcher and Astro development server together. Changes to src/config/config.toml are written to .astro/config.generated.json automatically.

Check, Test, And Build

npm run astro-check
npm test
npm run build

The production build regenerates the config, builds the static Astro site, removes draft pages from the sitemap, and writes the result to dist/.

Preview A Production Build

npm run preview

The preview script performs a fresh build before starting Astro Preview.

Other Verified Scripts

npm run format
npm run generate-favicons
npm run generate-multilingual-content
npm run remove-multilingual
npm run deploy:cf

deploy:cf runs wrangler pages deploy; configure Wrangler before using it.