Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions content/dev-guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ Unless instructed otherwise, follow this workflow:
5. Make it look great (see "Make it look great" below).
6. Run and test locally.
7. Deploy to production.
8. Run and test deployed app (see "Run and test deployed app" below).

## Make it look great

Expand All @@ -77,6 +78,14 @@ Unless the user has specified a design preference, use these defaults:

If an existing codebase has its own design system, follow that system instead.

## Run and test deployed app

- If the `databricks-apps` skill is available, follow its `agent-browser` reference to load the deployed app and test it; otherwise install `agent-browser` (`npm install -g agent-browser`) and drive the deployed URL with it directly.
- If anything is off, fix it.
- Inspect the app logs via the Databricks CLI and fix any errors.
- Redeploy and repeat until all issues are resolved.
- Report back to the user once the deployed app is verified.

## When you run into issues

Use the GitHub CLI (if available) or generate a copy-pastable error report for the user to file at https://github.com/databricks/devhub/issues. Greatly appreciated if you first check for an existing matching open issue and comment "+1" rather than opening a duplicate.