Create Vlang App

V-native scaffolding CLI — compose templates and extensions into production-ready V projects.

One command. Any V stack.

Official Site · Catalog · Templates · Contributing · Releases

---

Quick start

Install (recommended)

curl -fsSL https://create-awesome-vlang-app.vercel.app/install.sh | sh
# or
wget -qO- https://create-awesome-vlang-app.vercel.app/install.sh | sh

Installs create-vlang-app and a create-awesome-vlang-app alias into ~/.local/bin (override with CVA_INSTALL_DIR). Pin a version with CVA_VERSION=0.1.0.

Then scaffold:

create-vlang-app my-app --template web-server --addons github-setup
# or
create-awesome-vlang-app my-app --template web-server --addons github-setup

Fallback (raw script from this repo):

curl -fsSL https://raw.githubusercontent.com/Create-Vlang-App/create-vlang-app/main/scripts/install.sh | sh

Manual / pin a Release asset

Download a specific platform binary from create-vlang-app@0.1.0:

curl -fsSL -o create-vlang-app \
  "https://github.com/Create-Vlang-App/create-vlang-app/releases/download/create-vlang-app%400.1.0/create-vlang-app-linux-x86_64"
chmod +x create-vlang-app
mv create-vlang-app ~/.local/bin/

Also available via Homebrew (brew tap Create-Vlang-App/tap && brew install create-vlang-app) and AUR.

Build from source

Requires V (pinned in .v-version):

git clone https://github.com/Create-Vlang-App/create-vlang-app.git
cd create-vlang-app
make build
./create-vlang-app --help

Headless / CI:

create-vlang-app my-api \
  --template web-server \
  --addons github-setup \
  --no-interactive --force

List catalog entries:

create-vlang-app --list-templates
create-vlang-app --list-addons

Browse the live catalog at create-awesome-vlang-app.vercel.app/templates.

What this repo contains

Path	Purpose
modules/create_vlang_app_core	Scaffolding engine (catalog, fetch, merge, install)
modules/create_vlang_app	CLI binary
docs/	ADRs, distribution, VPM notes

Template and extension content lives in cva-templates. The CLI consumes:

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

Override with --catalog-path or a fork for local testing (file:// supported).

Ecosystem

Repository	Role
create-vlang-app (this repo)	CLI + core engine
cva-templates	Official templates and extensions
website	Docs / catalog UI → live site
homebrew-tap	Homebrew formula
aur-package	AUR PKGBUILD mirror

Local development

make test
make fmt
make vet
make build

CI uses vlang/setup-v with version-file: .v-version.

License

MIT

Contributors