CVA Templates

Official templates and extensions for create-vlang-app.

Compose a base template with optional overlays — one command, any V stack.

Official Site · Catalog · CLI · Contributing · Authoring

---

Quick start

Inicio rápido en español: instala la CLI con el comando siguiente, explora las plantillas en el sitio oficial y únete a la comunidad de Discord si necesitas ayuda.

Install the CLI, then scaffold:

curl -fsSL https://create-awesome-vlang-app.vercel.app/install.sh | sh

create-vlang-app my-app \
  --template web-server \
  --addons github-setup

# Headless / CI
create-vlang-app my-app \
  --template web-server \
  --addons github-setup \
  --no-interactive --force

Against this checkout:

create-vlang-app ./my-app \
  --template web-server \
  --addons github-setup \
  --catalog-path templates.json \
  --no-interactive --force --no-install

Browse templates and extensions on the live site: create-awesome-vlang-app.vercel.app.

Available templates

Template	Domain	Use case
web-server	Core	HTTP API with veb
cli-app	Core	CLI with cli + os
systems-app	Core	Low-level / systems binary
library-starter	Core	Publishable V library
vsl-starter	vsl	Scientific computing — linear algebra, stats, optimization
vtl-starter	vtl	Tensor / ML — n-dimensional arrays, autograd hooks
rxv-starter	rxv	Reactive — observable pipelines and event streams

Extensions

Overlay roots live under extensions/<slug>/template/. See each extension README.

Extension	Domain	Adds
github-setup	Core	GitHub Actions + setup-v
v-docker	Core	Dockerfile + compose
v-fmt-vet	Core	Makefile + pre-commit
v-postgres	Core	Postgres compose + env
v-sqlite	Core	SQLite config samples
development-container	Core	Dev container
vsl-plotting	vsl	vsl.plot wiring and chart samples
vsl-classical-ml	vsl	Classical ML smoke (linreg-style)
vtl-nn-cpu	vtl	Tiny CPU neural-network loop (CI-safe)
vtl-vsl-bridge	vtl + vsl	Tensor → VSL plot bridge
rxv-operators	rxv	filter / map / reduce beyond just

Registry

Canonical catalog: templates.json

https://raw.githubusercontent.com/Create-Vlang-App/cva-templates/main/templates.json

Layout

templates/<slug>/              # base project (includes docs/)
extensions/<slug>/README.md    # author docs (not merged)
extensions/<slug>/template/    # overlay merged into the project
ci/profiles/                   # L3 curated stacks
scripts/ci/                    # L0–L3 helpers
docs/                          # architecture, authoring, maintenance

CI

Workflow	Trigger	Scope
CI Integrity (L0)	PR + main	Schema, paths, docs bar, extension template/
CI Templates (L1)	PR + main	Every template via published CLI
CI Extensions (L2)	PR + weekly	Template × compatible addon
CI Profiles (L3)	PR + weekly	Curated stacks in ci/profiles/

Details: docs/TESTING.md, docs/CI_PUBLISHED_CLI.md.

Documentation

File	Contents
docs/ARCHITECTURE.md	Bank layout, template vs extension, merge model (mermaid diagram)
docs/AUTHORING.md	Adding templates and extensions
docs/AUTHORING.es.md	Guía de creación (traducción ES)
docs/DOMAIN_AUTHORING.md	vsl / vtl / rxv domain addons
docs/recipes/DOMAIN_RECIPES.md	Upstream vsl / vtl / rxv example galleries
docs/TESTING.md	Local testing and CI layers
docs/CI_PUBLISHED_CLI.md	Published CLI install (Release → git build fallback)
docs/TEMPLATE_QUALITY_M1.md	M1 quality bar for base templates
docs/MAINTENANCE_RUNBOOK.md	Operator runbook
docs/MAINTENANCE_CI.md	CI layer maintenance
docs/MAINTENANCE_SECURITY.md	Security policy
docs/MAINTENANCE_TEMPLATES.md	Template quality & slug stability
CONTRIBUTING.md	Contribution guide
CONTRIBUTING.es.md	Guía de contribución (ES)

Related repositories

• create-vlang-app — CLI + scaffolding engine
• website — docs site → live
• Create-Vlang-App — organization home

Contributors

Made with contributors-img.

License

MIT