Skip to content
vkma.dev

create-app

@vkma.dev/create-app scaffolds a VK Mini App in seconds: Vite plus the vkma.dev stack, TypeScript strict by default.

Окно терминала
npm create @vkma.dev/app my-app
# or: pnpm create @vkma.dev/app my-app · yarn create @vkma.dev/app my-app
# bun: bunx @vkma.dev/create-app my-app

Presets

Section titled “Presets”
Preset Stack
base React + Vite + @vkma.dev/bridge, devtools panel, deploy, no UI kit
vkui base + VKUI 8, Epic/Tabbar navigation on local state
router (default) base + @vkma.dev/router + VKUI, URL-driven views, panels, modals, popouts

Every generated app ships with:

  • @vkma.dev/bridge, the bridge with a built-in devtools tap
  • the devtools vite plugin mounting the /__vkma/ panel (bridge timeline, clients, execute)
  • @vkma.dev/deploy: vkma-deploy.config.ts, npm run deploy, npx vkma-deploy login
  • TypeScript (strict), engines, README, .gitignore

The vkui and router presets also ship @vkma.dev/vkui-bridge, a preassembled <VKBridgeConfigProvider> (host theme, safe-area insets, adaptivity, vkcom platform) wired in main.tsx.

CLI

Section titled “CLI”
Usage: npm create @vkma.dev/app [path] [flags]


Flags:
  --preset <id>   Preset to scaffold (default: router)
  --pm <id>       Package manager: npm | pnpm | yarn | bun
  --no-install    Skip installing dependencies
  --no-git        Skip git init
  -h, --help      Print this help

Interactive when attached to a TTY; fully flag-driven otherwise (CI-friendly).

Keeping templates fresh

Section titled “Keeping templates fresh”

Template dependency versions are updated automatically, so every scaffold hands out current ones; your package.json gets them as caret ranges.

Learn more

Section titled “Learn more”
  • Presets — what each one scaffolds and who it is for
  • CLI — flags, interactive and CI modes
  • App structure — the file tree, scripts, configs
Section titled “Links”