Create apps

Pick a product kind when you create a project. Kind is stored in vamp.toml and controls what vampcode run opens.

Interactive create

vampcode create
What kind of app do you want to create? [1] Desktop app native window UI + local backend [2] Web app routes, pages, and API handlers [3] Mobile app mobile-first screens + local API [4] Backend app API / services only (no UI) Choose [1-4] (default 1 · Desktop): Project name (default: my-desktop-app):

Flags

vampcode create my-shop --type web
vampcode create my-desk --type desktop
vampcode create my-mobile --type mobile
vampcode create my-api --type backend --yes

Desktop

kind = "desktop"

vampcode run . opens a native desktop window.

Web

kind = "web"

Localhost HTTP + default browser — not a desktop window.

Mobile

kind = "mobile"

Mobile-first UI scaffold in a native design window.

Backend

kind = "backend"

Services only. Call with vampcode call /api/….

Still seeing a desktop window for web? Confirm vamp.toml has kind = "web" and reinstall the CLI if needed.

After create (web)

cd my-web-app
vampcode run .                 # backend + open in BROWSER
vampcode run app/page.vamp     # web UI only
vampcode call /api/items -p .