This directory contains all the JS packages for adaptive cards:
adaptivecards- The renderer libraryadaptivecards-controls- A controls library useful for the designeradaptivecards-templating- A JSON-to-JSON templating and data binding library for use with Adaptive Cardsadaptivecards-designer- The drag-drop designer componentadaptivecards-designer-app- The designer app that consumes the designer componentadaptivecards-site- The generated website that is currently hosted at adaptivecards.ioadaptivecards-react- React.js library
Removed JS packages:
adaptivecards-fabric- A set of Fabric UI extensions for the Adaptive Cards JS renderer. This package has been deprecated. Please migrate toadaptivecards-fluentui. The source code is available in 21.09 or before releases.
- Install Node 20+
cd source/nodejsnpm install -g vsts-npm-authvsts-npm-auth -config .npmrc
We use lerna to manage package linking and building.
cd source/nodejsnpm install
npx lerna run build
cd adaptivecards-designernpm start- OR to test preview features:
npm run start:preview
Note: The documentation side can also be used to validate designer changes.
Start the documentation site (http://adaptivecards.io)
cd adaptivecards-sitenpx lerna run releasenpm start- Open up the browser to point to:
localhost:[portnumber]printed after the command above returns under "Hexo is running at".
If you do not see your changes, you are likely pulling from the cache. Please try:
npx lerna run cleannpx lerna run release --skip-nx-cachenpm start
npx lerna add <new-package> --scope=<install-target>
The JS Renderer currently supports the following type of testing:
| Type | Project | Location |
|---|---|---|
| Unit tests | adaptivecards/__tests__ | Location |
| Unit tests | unit-tests | Location |
| UI tests | ui-tests | Location |
cd adaptivecards- Build the project:
npm run build npm test
cd tests/unit-testsnpm run build-and-test
Pre-requisite 1: adaptivecards-ui-testapp must be executing
0.1 cd adaptivecards-ui-testapp
0.2 npm run build
0.3 npm run start
Pre-requisite 2: Web drivers must be installed, if working with edge it can be downloaded from here
cd tests/ui-testsnpm run buildnpm run test