[eric] docs: app builder skill refers to the dashboard card, not the deleted Apps page

This commit is contained in:
ciregenz
2026-07-02 03:21:36 -07:00
parent 227bd1badc
commit c0a40a4425
+5 -5
View File
@@ -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":