Feature/dab builder app

README.md

@@ -141,14 +141,25 @@ irm https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/insta
 
 ### Visual Builder App
 
-Full-stack web application with chat UI for Databricks development:
+Full-stack web application with chat UI for Databricks development. Deploys a Lakebase database and Databricks App with a single command:
 
 ```bash
 cd ai-dev-kit/databricks-builder-app
-./scripts/setup.sh
-# Follow instructions to start the app
+
+# Deploy everything (Lakebase + app + permissions)
+./scripts/deploy.sh my-builder-app --profile <your-profile>
+```
+
+For local development:
+
+```bash
+./scripts/setup.sh        # Install dependencies
+# Edit .env.local with your credentials
+./scripts/start_dev.sh    # Start locally at http://localhost:3000
 ```
 
+See [`databricks-builder-app/`](databricks-builder-app/) for full documentation.
+
 
 ### Core Library
 

databricks-builder-app/.env.example

@@ -102,37 +102,8 @@ MLFLOW_TRACKING_URI=databricks
 # DEPLOYMENT TO DATABRICKS APPS
 # =============================================================================
 #
-# To deploy this app to Databricks Apps:
+# The deploy script handles everything automatically:
+#   ./scripts/deploy.sh <app-name> --profile <your-profile>
 #
-# 1. Prerequisites:
-#    - Databricks CLI installed and configured (databricks auth login)
-#    - A Lakebase instance created in your workspace (autoscale or provisioned)
-#
-# 2. Create the app:
-#    databricks apps create <your-app-name>
-#
-# 3. Configure app.yaml:
-#    cp app.yaml.example app.yaml
-#    # Edit app.yaml — set LAKEBASE_ENDPOINT (autoscale) or
-#    # LAKEBASE_INSTANCE_NAME (provisioned) and your LLM model settings
-#
-# 4. Add Lakebase as an app resource (provisioned only — autoscale uses OAuth directly):
-#    databricks apps add-resource <your-app-name> \
-#      --resource-type database \
-#      --resource-name lakebase \
-#      --database-instance <your-lakebase-instance-name>
-#
-# 5. Grant table permissions to the app's service principal:
-#    (Run this SQL in a notebook or SQL editor after first deployment)
-#    
-#    GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public 
-#      TO `<service-principal-id>`;
-#    GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public 
-#      TO `<service-principal-id>`;
-#    ALTER DEFAULT PRIVILEGES IN SCHEMA public 
-#      GRANT ALL ON TABLES TO `<service-principal-id>`;
-#
-# 6. Deploy:
-#    ./scripts/deploy.sh <your-app-name>
-#
-# For more details, see the README.md
+# This provisions Lakebase, creates the app, grants permissions, and deploys.
+# See README.md for full details and options.

databricks-builder-app/.gitignore

@@ -37,3 +37,4 @@ docs/TODO.md
 
 # OS
 .DS_Store
+uv.lock