# @microsoft/adaptivecards-tools

> Microsoft sdk for Adaptive Cards

Latest version **1.3.11** (published 2026-03-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @microsoft/adaptivecards-tools
pnpm add @microsoft/adaptivecards-tools
yarn add @microsoft/adaptivecards-tools
bun add @microsoft/adaptivecards-tools
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.3.11 |
| Published | 2026-03-11 |
| First published | 2021-11-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 19.2 KB |
| Known vulnerabilities | 0 (+5 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 786 |
| Author | Microsoft Corporation |
| Maintainers | microsoft1es, microsoft-oss-releases, zhyuer, nintan, msteamsfx |

## Links

- npm: https://www.npmjs.com/package/@microsoft/adaptivecards-tools
- Repository: https://github.com/OfficeDev/TeamsFx
- Issues: https://github.com/OfficeDev/TeamsFx/issues
- npm.io page: https://npm.io/package/@microsoft/adaptivecards-tools

## Dependencies (5)

- [react](https://npm.io/package/react.md) ^17.0.2
- [markdown-it](https://npm.io/package/markdown-it.md) ^13.0.2
- [adaptivecards](https://npm.io/package/adaptivecards.md) ~2.10.0
- [adaptive-expressions](https://npm.io/package/adaptive-expressions.md) ^4.20.0
- [adaptivecards-templating](https://npm.io/package/adaptivecards-templating.md) ^2.1.0

## Recent versions

- 1.3.11 (latest) — 2026-03-11
- 1.3.12-beta.2026042308.0 (beta) — 2026-04-23
- 1.3.12-alpha.ae6279f56d.0 (alpha) — 2026-04-22
- 1.3.11-rc.0 (rc) — 2026-03-06
- 1.3.12-beta.2026042201.0 — 2026-04-22
- 1.3.12-beta.2026042121.0 — 2026-04-21
- 1.3.12-alpha.bca8bf68d3.0 — 2026-04-21
- 1.3.12-alpha.18b7addf61.0 — 2026-04-21
- 1.3.12-alpha.e369130fbe.0 — 2026-04-20
- 1.3.12-alpha.cc581ebec3.0 — 2026-04-17
- 1.3.12-alpha.8b16707e4a.0 — 2026-04-16
- 1.3.12-alpha.0a63a75aae.0 — 2026-04-15
- 1.3.12-alpha.5d45794619.0 — 2026-04-14
- 1.3.12-alpha.3d0c608284.0 — 2026-04-13
- 1.3.12-alpha.5e0780e0c.0 — 2026-04-10
- … 1307 more at https://npm.io/package/@microsoft/adaptivecards-tools/versions

## README

# AdaptiveCards SDK for TypeScript/JavaScript

> This package will be deprecated by 2025-08. Please use [adaptivecards-templating](https://www.npmjs.com/package/adaptivecards-templating) instead.

Adaptivecards-tools sdk aims to reduce developer's efforts to render an Adaptive Card in your project, especially for Adaptive Card with Data, provide type safety check.

## Getting started

### Install the `@microsoft/teamsfx` package

Install the adaptivecards-tools sdk for TypeScript/JavaScript with `npm`:

```bash
npm install @microsoft/adaptivecards-tools
```

### Create a card without data
```ts
import { AdaptiveCards } from "adaptivecards-tools";
import rawWelcomeCard from "./adaptiveCards/welcome.json"

const card = AdaptiveCards.declareWithoutData(rawWelcomeCard).render();
await context.sendActivity({ attachments: [CardFactory.adaptiveCard(card)] });
```

### Create a card with data
```ts
import { AdaptiveCards } from "adaptivecards-tools";
import rawWelcomeCard from "./adaptiveCards/welcome.json"

export interface DataInterface {
  likeCount: number
}

const card = AdaptiveCards.declare<DataInterface>(rawLearnCard).render(this.likeCountObj);
await context.sendActivity({ attachments: [CardFactory.adaptiveCard(card)] });
```

---
_Source: https://npm.io/package/@microsoft/adaptivecards-tools · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._