raw-app

Creates Windmill raw apps with CLI scaffolding, backend runnables, and datatable configuration.

Updated May 28, 2026
One-click install
npx skills add https://github.com/kma-core/windmill --skill raw-app-kma-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: raw-app
Source: https://github.com/kma-core/windmill/tree/main/system_prompts/auto-generated/skills/raw-app
Command: npx skills add https://github.com/kma-core/windmill --skill raw-app-kma-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building custom frontends on Windmill requires knowing the exact CLI flags, on-disk file layout, and datatable wiring conventions; this Skill guides an AI agent through scaffolding and structuring raw apps correctly without interactive prompts hanging or misconfigured runnables. ## Core Features & Use Cases - Non-interactive app scaffolding: Runs wmill app new with explicit --summary, --path, and --framework flags (react19, react18, svelte5, vue), gathering missing values from the user first. - Backend runnable management: Defines inline runnables via extension-based files (TypeScript, Python, Go, Bash, SQL, and more) or references existing scripts, flows, and hub scripts via YAML config. - Datatable integration: Configures whitelisted PostgreSQL tables in raw_app.yaml and manages SQL migrations through the sql_to_apply/ folder with the dev server. - Use Case: Ask the agent to create a customer dashboard app; it collects the summary, path, and framework, runs the CLI, scaffolds backend runnables that query whitelisted datatables, and offers a visual preview. ## Quick Start Ask the agent to create a new Windmill raw app and provide a summary, a path like f/sales/dashboard, and a framework such as react19.

Frequently Asked Questions about raw-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Windmill raw app from the CLI?

Run `wmill app new` with the `--summary`, `--path`, and `--framework` flags to scaffold the app non-interactively. Passing any of these flags skips the interactive wizard, which would otherwise hang waiting for stdin in non-TTY environments.

What frameworks does wmill app new support?

The `--framework` flag accepts react19 (recommended), react18, svelte5, and vue. The frontend is bundled with esbuild using index.tsx as the entrypoint.

How do backend runnables work in Windmill raw apps?

Each file in the backend/ folder becomes a runnable whose ID is the filename without extension, with language determined by extension (e.g., .ts, .py, .go, .pg.sql). The frontend calls them through generated bindings like `backend.get_user(args)`.

Can a raw app frontend query the database directly?

No, the frontend never queries datatables directly. Backend runnables are the only bridge, and they can only access tables explicitly whitelisted in the data.tables section of raw_app.yaml.

Why does wmill app new hang when run by an AI agent?

The bare command launches an interactive wizard that waits for stdin, which hangs in any non-TTY context. Always pass --summary, --path, and --framework flags to run it in non-interactive mode.

How do I add database tables to a Windmill raw app?

Create numbered SQL migration files in the sql_to_apply/ folder, then run `wmill app dev` so the dev server prompts to execute them. Afterward, whitelist the new tables in the data.tables list in raw_app.yaml.