appflare

Guides building Appflare backends on Cloudflare Workers from schema DSL to generated client.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Imtiajrex/appflare-skills --skill appflare-imtiajrex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: appflare
Source: https://github.com/Imtiajrex/appflare-skills/tree/main/skills/appflare
Command: npx skills add https://github.com/Imtiajrex/appflare-skills --skill appflare-imtiajrex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working in Appflare projects need to understand the generate-first workflow, recognize project structure, and know which focused skill to load for schema, handlers, querying, client, or deployment tasks. ## Core Features & Use Cases - Project Recognition: Identifies Appflare backends via appflare.config.ts, schema.ts, and _generated output directories. - Dev Loop Guidance: Walks through the standard workflow of editing schema and handlers, regenerating with bun appflare dev, and running migrations. - Skill Routing: Directs to the right focused skill (appflare-schema, appflare-handlers, appflare-querying, appflare-client, appflare-cli-deploy) based on the task. - Use Case: When asked to add a new posts table with a list endpoint, this skill explains editing schema.ts, adding a query handler, regenerating, migrating locally, and calling the route from the generated client. ## Quick Start Ask the agent to add a new table and query endpoint to your Appflare backend and it will follow the dev loop and load the right focused skills.

Frequently Asked Questions about appflare

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

FAQPage Schema
How do I build a backend with Appflare on Cloudflare Workers?▼

Define tables in schema.ts using schema() and table(), write query and mutation handlers under the scanDir, then run bun appflare dev to generate the Hono Worker and typed client. Apply schema changes to D1 with bun appflare migrate --local.

How do I add a new table or endpoint in an Appflare project?▼

Edit schema.ts to add the table, create a handler file exporting const name = query({...}) under the scanDir, then regenerate with bun appflare dev and run bun appflare migrate --local. The route name derives from the file path and export name.

Why are my Appflare routes or types missing after a change?▼

Generated code is stale until you regenerate. Run bun appflare dev from the backend package and confirm it finishes without errors, then run bun appflare migrate --local if the schema changed.

Can I run the Appflare CLI with Node or npx?▼

No, the Appflare CLI only runs under Bun. Always use bun appflare <cmd> and never node or npx, otherwise commands will fail.

Why is ctx.user null in my Appflare handler?▼

ctx.user is typed non-null but is null for anonymous requests unless the handler sets authRequired: true. It is always null in scheduler and cron handlers since those run without a user session.