@lightdash/cli 1.48.1 → 1.50.0

package/README.md

@@ -42,6 +42,36 @@ the AI agent runtime version.
 Access lists, Slack integrations, MCP servers, documents, conversations, and
 other runtime state stay managed in the target environment.
 
+## Data apps as code
+
+Create a new data app locally from the same starter used by Lightdash's data
+app builder:
+
+```shell
+lightdash create app "Revenue explorer"
+```
+
+This requires npm. Before writing anything, the command first warns that it
+will download packages and run shadcn locally, then asks whether to show and
+approve the exact direct dependencies and shadcn components. It creates
+`lightdash/apps/revenue-explorer/` with runnable source, the
+Lightdash data app and local-development agent skills, and a point-in-time
+snapshot of the selected project's semantic layer. Use `--project`, `--slug`,
+`--description`, or `--path` to override the defaults; use `--assume-yes` to
+approve installation in a non-interactive environment.
+
+Build and upload it with:
+
+```shell
+cd lightdash/apps/revenue-explorer
+npm run build
+lightdash upload --apps revenue-explorer
+```
+
+The local build is a pre-flight check; Lightdash rebuilds the source when it is
+uploaded. Existing apps can still be checked out with
+`lightdash download --apps <slug>`.
+
 ## Development
 
 First build the package