app-backend

Implements optional Hono-based backend layers with REST APIs, WebSockets, and cron jobs for Fusebase apps.

5|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/ryan-haver/fusebase-mcp --skill app-backend-ryan-haver
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: app-backend
Source: https://github.com/ryan-haver/fusebase-mcp/tree/main/apps/client-portal-dashboard/.claude/skills/app-backend
Command: npx skills add https://github.com/ryan-haver/fusebase-mcp --skill app-backend-ryan-haver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires hono, @hono/node-server, @hono/node-ws, tsx, tsup, typescript.

What problem does it solve? Fusebase apps sometimes need server-side logic beyond the client-side Dashboard SDK, such as custom REST endpoints, WebSocket push, scheduled jobs, or secret-bearing operations, and this Skill guides when and how to add that backend correctly. ## Core Features & Use Cases - Backend Scaffolding: Sets up a backend/ folder with its own package.json using Hono, tsx, and tsup, keeping backend dependencies out of the SPA bundle. - API Contract Management: Maintains openapi.json as the published API contract with x-fusebase-visibility and x-fusebase-execution-mode metadata for registry discovery. - Sidecars & Resource Budgets: Adds Docker sidecar containers (Chromium, Redis) while respecting the 2.0 CPU / 4 Gi total revision cap. - Auth & Webhooks: Handles service-account tokens, magic-link session exchange, webhook registration, cold starts, and multi-user state partitioning. - Use Case: When building an app that must receive Stripe webhooks and write to an isolated store, use this Skill to configure backend.minReplicas: 1, a secret webhook path, and the correct FBS_FEATURE_TOKEN transport. ## Quick Start Ask the AI to add a Hono backend with a REST endpoint and update openapi.json for my Fusebase app.

Frequently Asked Questions about app-backend

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a backend to a Fusebase app?▼

Create a `backend/` folder inside the app with its own package.json using Hono, @hono/node-server, and tsx, then register dev, build, and start commands in the `backend` block of fusebase.json. Only add a backend when the app genuinely needs server-side logic beyond the Dashboard SDK.

When should I add a backend versus using the Dashboard SDK?▼

Add a backend only for custom business logic, WebSocket push, server-side API composition, scheduled tasks, or operations needing secrets. For plain CRUD on dashboard data, call the Dashboard SDK directly from the SPA without any backend.

How do I add a sidecar container to a Fusebase app backend?▼

Run `fusebase sidecar add --app <appPath> --name chromium --image browserless/chrome:latest --port 9222`. The sidecar shares localhost with the backend, and the combined CPU and memory of backend plus all sidecars must stay within 2.0 CPU and 4 Gi.

Why do my backend requests time out after deploy?▼

The backend scales to zero when idle, so the first request after idle or deploy pays a roughly 10 second cold start. Set client timeouts to at least 15 seconds, and for webhook apps set `backend.minReplicas: 1` in fusebase.json to keep one replica warm.

How do webhooks authenticate with a Fusebase app backend?▼

The platform proxy skips app-token auth for any path under `/api/webhooks/`, so external providers can post there without a session cookie. Use a random hard-to-guess path segment and register the webhook subscription with the provider yourself during deploy.

Why is my new backend route not discoverable after deploy?▼

Fusebase reads `openapi.json` at deploy time for registry publication and discovery; Hono routes are not scanned automatically. Any route change requires a matching update to `openapi.json`, verified with `fusebase api validate` before deploying.