mirror of
https://github.com/openswarm-ai/openswarm.git
synced 2026-08-17 18:25:42 +02:00
[eric] docs: app builder skill refers to the dashboard card, not the deleted Apps page
This commit is contained in:
@@ -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":
|
||||
|
||||
Reference in New Issue
Block a user