Skip to main content

Apps

Listing apps

The wmill app list command is used to list all apps in the remote workspace.

wmill app

Pushing an app

Pushing an app to a Windmill instance is done using the wmill app push command.

wmill app push <file_path>

Arguments

ArgumentDescription
file_pathThe path to the app file to push.

Examples

  1. Push the app located at ./my_app.json.
wmill app push ./my_app.json

Full-code app commands

The CLI provides additional commands for full-code apps:

Create a new full-code app

wmill app new

Interactive wizard to scaffold a full-code app with React, Svelte or Vue.

Start the dev server

From the app directory:

wmill app dev

Starts a local development server with hot reload and WebSocket backend. Options: --port, --host, --entry, --no-open.

Generate lock files

Generate .lock files for backend runnables with dependencies using the wmill generate-metadata command:

wmill generate-metadata

To only update app lockfiles, use:

wmill generate-metadata --skip-scripts --skip-flows

Options: --yes, --dry-run, --default-ts.

Legacy command

Prior to the unified command, this was done with wmill app generate-locks. This command is now deprecated but still works.

Generate agent documentation

From the app directory:

wmill app generate-agents

Generates AGENTS.md and DATATABLES.md for AI coding agent context.

Remote path format

<u|g|f>/<username|group|folder>/...