app-sidecarlisted
Install: claude install-skill fusebase-dev/fusebase-flow
# App Sidecar Containers
Sidecars are pre-built Docker images deployed alongside an app backend in the same network namespace (sharing localhost). They enable auxiliary services that the backend communicates with over HTTP or other protocols on localhost.
## Prerequisites
1. App must have a `backend/` folder configured in `fusebase.json`
## Use Cases
| Sidecar | Image Example | Port | Purpose |
|---------|---------------|------|---------|
| Headless browser | `browserless/chrome:latest` | 9222 | Web scraping, PDF generation, screenshots |
| Lightweight browser | `nicholasgriffintn/lightpanda:latest` | 9222 | Fast page parsing |
| Redis cache | `redis:7-alpine` | 6379 | Caching, queues, pub/sub |
| Image processor | `dpokidov/imageproxy:latest` | 8080 | Image resizing/optimization |
## CLI Commands
### Add a Sidecar
```bash
fusebase sidecar add \
--app <appId> \
--name <name> \
--image <dockerImage> \
[--port <port>] \
[--tier small|medium|large] \
[--env KEY=VALUE ...] \
[--secret KEY|KEY:ALIAS ...]
```
Example:
```bash
fusebase sidecar add \
--app my-scraper \
--name chromium \
--image browserless/chrome:latest \
--port 9222 \
--tier medium \
--env MAX_CONCURRENT_SESSIONS=5 \
--env CONNECTION_TIMEOUT=30000
```
### Remove a Sidecar
```bash
fusebase sidecar remove --app <appId> --name <name>
```
### List Sidecars
```bash
fusebase sidecar list --app <appId>
```
`--feature` (`-f`) is accepted as a deprecated alias for `--app` (`-a`).
#