adaptive-cards-backend-host

Stars1

Forks1

UpdatedJuly 28, 2026 at 14:22

Optional flutter_adaptive_cards_host_fs package — backend invoke serialization, PlainJson/Teams adapters, AdaptiveCardBackendHandlers, and response effects. Use when wiring Submit/Execute/Refresh/onChange to a flow-service or reviewing associatedInputs + invoke round-trips.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

freemansoft

freemansoft/Flutter-AdaptiveCards

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	adaptive-cards-backend-host
description	Optional flutter_adaptive_cards_host_fs package — backend invoke serialization, PlainJson/Teams adapters, AdaptiveCardBackendHandlers, and response effects. Use when wiring Submit/Execute/Refresh/onChange to a flow-service or reviewing associatedInputs + invoke round-trips.

Backend Host Integration Skill

Optional package: packages/flutter_adaptive_cards_host_fs

Depends on: flutter_adaptive_cards_fs, http
Published: Yes — pub.dev (barrel: lib/flutter_adaptive_cards_host_fs.dart)
Docs: docs/backend-host-integration.md
Design history: docs/archive/specs/2026-06-07-backend-host-integration-design.md

When to use

Scenario	Package
Render cards; hand-wire `InheritedAdaptiveCardHandlers`	Core only
Teams-correct invoke payloads (`associatedInputs`)	Core (always)
Serialize → POST → parse → `applyTo` automatically	`flutter_adaptive_cards_host_fs`

Key types

AdaptiveCardBackendHandlers — wraps card subtree; wires onSubmit, onExecute, onRefresh, onChange
AdaptiveCardBackendClient / HttpAdaptiveCardBackendClient — transport
PlainJsonInvokeAdapter / TeamsInvokeAdapter — request/response JSON shapes
AdaptiveCardInvokeResponse.applyTo — applyPatches, setInputErrors, replaceCard (via onCardReplaced)

Requires shared GlobalKey<RawAdaptiveCardState> on handlers and RawAdaptiveCard (except onChange, which uses invoke.cardState).

Tests

No golden tests. Run from package directory:

cd packages/flutter_adaptive_cards_host_fs
fvm flutter test

Primary files:

test/handlers/backend_handlers_test.dart
test/adapters/plain_json_invoke_adapter_test.dart
test/adapters/teams_invoke_adapter_test.dart
test/client/http_backend_client_test.dart

Core associatedInputs tests remain in packages/flutter_adaptive_cards_fs/test/utils/associated_inputs_test.dart and related input tests.

Related skills

adaptive-cards-monorepo-workspace — workspace layout and fvm working directories
adaptive-cards-testing — core widget/notifier test patterns
adaptive-cards-release-engineer — sync version: and flutter_adaptive_cards_fs: ^<version> on post-release bump

More from this repository

same repository

adaptive-cards-accessibility

freemansoft/Flutter-AdaptiveCards

Semantics contract for Adaptive Card elements — how labels, headings, live regions, and decorative-vs-meaningful images are exposed to screen readers, and how to test them with `tester.ensureSemantics()`. Use when adding or changing any element, input, or action widget, and at code review.

2026-07-281

adaptive-cards-code-review

freemansoft/Flutter-AdaptiveCards

Use when finalizing a change in the Flutter-AdaptiveCards monorepo — before you propose, commit, or merge — as the manual or AI-assisted review gate. Checks monorepo hygiene, Adaptive Cards spec compliance, theming, widget keys, accessibility, and testing.

2026-07-281

adaptive-cards-dart-flutter-fvm

freemansoft/Flutter-AdaptiveCards

FVM rules for the Flutter-AdaptiveCards monorepo. Prefix every `flutter` and `dart` shell command with `fvm`. Use when vendored dart/flutter skills show bare commands, when installing or switching the pinned SDK, or before analyze, test, pub, or build_runner workflows.

2026-07-281

adaptive-cards-diataxis-docs

freemansoft/Flutter-AdaptiveCards

Classify, audit, and enforce the Diátaxis documentation framework across the Flutter-AdaptiveCards canonical `docs/` and package READMEs. Keeps each doc in exactly one quadrant (tutorial / how-to / reference / explanation) and flags mixed-mode drift. Use when writing or reviewing a doc under `docs/`, adding a `doc_type:` front-matter tag, auditing the doc set for gaps or violations, or when the user mentions Diátaxis or documentation structure. Advisory only — it proposes splits, it does not silently move or rewrite files.

2026-07-281

adaptive-cards-element-registry

freemansoft/Flutter-AdaptiveCards

Use before adding a new Adaptive Card element type — implementing its widget, registering it, or testing it. Covers the StatefulWidget + mixin pattern, CardTypeRegistry registration, the extension API, and optional packages (charts).

2026-07-281

adaptive-cards-flutter-standard-practices

freemansoft/Flutter-AdaptiveCards

Use when writing or reviewing model (de)serialization or theming in this repo, or before adding a `fromJson`/`toJson`. The library packages diverge from two things generic Flutter skills assume: they hand-write serialization (no `json_serializable` / code-gen) and style elements from HostConfig (not app-level `ThemeData`/`GoogleFonts`). Read this when a generic skill or habit points you at `@JsonSerializable`, `build_runner` for models, or `ColorScheme` app theming inside `packages/`.

2026-07-281

name	adaptive-cards-backend-host
description	Optional flutter_adaptive_cards_host_fs package — backend invoke serialization, PlainJson/Teams adapters, AdaptiveCardBackendHandlers, and response effects. Use when wiring Submit/Execute/Refresh/onChange to a flow-service or reviewing associatedInputs + invoke round-trips.

Backend Host Integration Skill

Optional package: packages/flutter_adaptive_cards_host_fs

Depends on: flutter_adaptive_cards_fs, http
Published: Yes — pub.dev (barrel: lib/flutter_adaptive_cards_host_fs.dart)
Docs: docs/backend-host-integration.md
Design history: docs/archive/specs/2026-06-07-backend-host-integration-design.md

When to use

Scenario	Package
Render cards; hand-wire `InheritedAdaptiveCardHandlers`	Core only
Teams-correct invoke payloads (`associatedInputs`)	Core (always)
Serialize → POST → parse → `applyTo` automatically	`flutter_adaptive_cards_host_fs`

Key types

AdaptiveCardBackendHandlers — wraps card subtree; wires onSubmit, onExecute, onRefresh, onChange
AdaptiveCardBackendClient / HttpAdaptiveCardBackendClient — transport
PlainJsonInvokeAdapter / TeamsInvokeAdapter — request/response JSON shapes
AdaptiveCardInvokeResponse.applyTo — applyPatches, setInputErrors, replaceCard (via onCardReplaced)

Requires shared GlobalKey<RawAdaptiveCardState> on handlers and RawAdaptiveCard (except onChange, which uses invoke.cardState).

Tests

No golden tests. Run from package directory:

cd packages/flutter_adaptive_cards_host_fs
fvm flutter test

Primary files:

test/handlers/backend_handlers_test.dart
test/adapters/plain_json_invoke_adapter_test.dart
test/adapters/teams_invoke_adapter_test.dart
test/client/http_backend_client_test.dart

Core associatedInputs tests remain in packages/flutter_adaptive_cards_fs/test/utils/associated_inputs_test.dart and related input tests.

Related skills

adaptive-cards-monorepo-workspace — workspace layout and fvm working directories
adaptive-cards-testing — core widget/notifier test patterns
adaptive-cards-release-engineer — sync version: and flutter_adaptive_cards_fs: ^<version> on post-release bump