Local development

The CLI manages apps and servers through blueprint.dev.json. Keeping paths, ports, environment, and dependencies together lets a workspace start one server or an interactive app using the same configuration.

Get package access first

Contact Vyuh Technologies for a pub.vyuh.tech token. Follow package access to authenticate and install the CLI. See the package map for the role of each package.

Start in an existing project

With the CLI installed and project dependencies resolved:

blueprint init
blueprint doctor
blueprint dev

Initialization discovers packages qualified by their Blueprint dependencies. It creates a profile without overwriting an existing file. Review discovered ports and supply environment, health checks, and dependency ordering before startup. Development profiles covers installation, discovery rules, and the complete JSON format.

A missing profile is a doctor warning with initialization guidance; setup diagnostics remain available.

Add new discoveries

blueprint init --update --dry-run
blueprint init --update

Updates preserve existing service names, settings, and default selections. New services are appended to the defaults; existing entries are not removed. Discovery supplies a starting point while your edited profile remains authoritative.

Run together or independently

blueprint targets
blueprint dev
blueprint app
blueprint serve api
blueprint restart api
blueprint status
blueprint logs --follow
blueprint stop

Replace app and api with names from your profile. dev starts servers with their dependencies. Run app in another terminal for native Flutter controls; serve api starts only that server. stop stops managed sessions for the profile. External services stay outside CLI process ownership.

Flutter entries select their device, Wasm setting, build mode, entrypoint, and Dart defines in the same profile as their servers.

A shorter feedback loop

• blueprint doctor checks commands, ports, dependencies, and configuration.
• blueprint dev --watch restarts servers when configured watch paths change.
• blueprint restart api restarts a managed server without closing the app.
• blueprint app keeps Flutter hot-reload controls in its own terminal.
• blueprint stop waits for managed services to shut down.

Create from a local template

blueprint create my_app --template /path/to/trusted/template

Creation requires a trusted local template. Products supply domain declarations, provider bindings, and database setup. The CLI does not provision identity or storage. See developer commands for target-level serving, generation, and installation.