From c0a40a442554994a2eb9512a48cd0dfcf09bec4a Mon Sep 17 00:00:00 2001 From: ciregenz Date: Thu, 2 Jul 2026 03:21:36 -0700 Subject: [PATCH] [eric] docs: app builder skill refers to the dashboard card, not the deleted Apps page --- backend/apps/outputs/app_builder_skill.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/backend/apps/outputs/app_builder_skill.md b/backend/apps/outputs/app_builder_skill.md index 51375f07..c4f15882 100644 --- a/backend/apps/outputs/app_builder_skill.md +++ b/backend/apps/outputs/app_builder_skill.md @@ -447,7 +447,7 @@ Spotify-style player) don't need this: their actions are already at agent cadenc ## Debugging — use `swarm_debug`, not `print()` The backend has `swarm_debug` pre-installed. It's a colored frame-aware -logger that lands in the App Builder's **Terminal** tab under `[BACKEND]`. +logger that lands in the app card's **Terminal** view under `[BACKEND]`. ```python from swarm_debug import debug @@ -462,7 +462,7 @@ reference. `print()` works too but lacks the variable-name inference and colorization. Frontend `console.log/warn/error` calls land in the Terminal pane under -`[FRONTEND]` via the App Builder's webview-preload bridge. Same chronological +`[FRONTEND]` via the app card's webview-preload bridge. Same chronological stream as `[BACKEND]` lines, so you can correlate cause and effect across the two halves of your stack. @@ -512,7 +512,7 @@ Common deps already in the template: - **Edits are auto-saved**. As soon as you write a file via the Edit/Write tool, it's on disk. Vite HMR re-renders the preview within ~100ms. - **`bash restart.sh` restarts the app runtime yourself** — backend + vite, no user action needed. Use it after `bash backend_init.sh`, after editing `.env`, or whenever backend code must reload (uvicorn runs WITHOUT --reload, so backend edits do NOT hot-apply). Never ask the user to restart for you, and never try to kill/rerun run.sh — the harness owns the process. If `restart.sh` is missing (older app), `mkdir -p .openswarm && touch .openswarm/restart-requested` does the same thing. - After a restart, wait a few seconds and check `.openswarm/terminal.log` to confirm the boot looked clean. -- **`meta.json`** at workspace root drives the app's name + description in the OpenSwarm sidebar, App Builder header, and Apps page. Write it FIRST when starting a new app (see step 1 of the Quick start checklist), and revise it any time the app's purpose shifts. +- **`meta.json`** at workspace root drives the app's name + description in the OpenSwarm sidebar and on the app's live card on the dashboard. Write it FIRST when starting a new app (see step 1 of the Quick start checklist), and revise it any time the app's purpose shifts. --- @@ -554,7 +554,7 @@ The three most common ways agent edits crash a React preview: Then run `bash restart.sh`. The workspace's `frontend/node_modules` will re-symlink to the shared warm cache on next vite boot — only - ONE React copy exists across all App Builder apps, so the + ONE React copy exists across all OpenSwarm apps, so the duplicate is gone. The `.vite-cache` wipe is important because vite caches pre-bundled deps including the duplicate React. @@ -588,7 +588,7 @@ When making a new app from scratch: 1. **WRITE `meta.json` FIRST**, before any other tool call. Put a 1-3 word product name (Title Case) in `name` and a one-sentence description in `description`. - The Apps sidebar and the App Builder header show this name to the user; until + The sidebar and the app's dashboard card show this name to the user; until you write it, both surfaces sit at "Untitled App". Don't wait until the end of the turn to fill it in, pick a name from the user's prompt and ship it now. Example: prompt "make doodle jump" → `{"name": "Doodle Jumper", "description":