# Changelog ## v2.1.0 - 2026-05-20 ### Added - Add `--dry-run` flag to `canva apps migrate` command to allow previewing of changes. ## v2.0.2 - 2026-05-06 ### Fixed - Fixed the `Read Canva App UI Kit Page` MCP tool losing valid prop values for components with overloaded signatures (e.g. `Button`'s `size` and `icon` props). ### Security - Dependencies audit bringing modules up to date: ```text diff 8.0.3 -> 8.0.4 tar 7.5.11 -> 7.5.13 ``` ## v2.0.1 - 2026-04-29 ### Fixed - Maintenance release only, with internal fixes and improvements. ## v2.0.0 - 2026-04-21 ### Removed - Dropped support for Node.js 20. The minimum supported version is now Node.js 22. ### Changed - Updated colorSurface token in the App UI Kit v5 migration to match current Canva behaviour. ## v1.23.0 - 2026-04-01 ### Added - Added new permission scope to read brand template data ## v1.22.0 - 2026-03-25 ### Added - Added doctor check to verify SDK dependency requirements (e.g. React version). ### Changed - Updated the recommended node.js/npm version to v24/v11 respectively. ### Fixed - The npm package was not including licenses for all bundled dependencies. ## v1.21.0 - 2026-03-11 ### Changed - Dependencies audit bringing modules up to date: ```text @modelcontextprotocol/sdk 1.25.2 -> 1.27.1 ajv 8.17.1 -> 8.18.0 diff 8.0.2 -> 8.0.3 systeminformation 5.27.14 -> 5.31.4 tar 7.5.4 -> 7.5.11 ``` ### Fixed - Installing npm dependencies when creating a new app could occasionally fail. - Fix duplicate 'Done!' message shown after completing apps create. ## v1.20.0 - 2026-02-19 ### Changed - Updated README instructions to link to the docs for available `--template` options. - Templates are now downloaded from the `canva-sdks/canva-apps-sdk-starter-kit` repository instead of being bundled with the CLI. ## v1.19.0 - 2026-02-11 ### Changed - Upgraded `@canva/design` to `2.8.0`. - Upgraded `@canva/intents` to `2.2.0`. ## v1.18.0 - 2026-02-05 ### Changed - Upgraded `@canva/intents` to `2.1.2`. ## v1.17.0 - 2026-02-03 ### Added - Added mocking for `@canva/intents` package in `jest.setup.ts` for each template. ### Changed - Template selection during `canva apps create` now wraps around when navigating with arrow keys - Updated CLI templates to use `@canva/app-ui-kit` component props instead of CSS classes for layout styling. - Upgraded `@canva/intents` to `2.1.0`. ### Fixed - Fixed an issue in the template for the Content Publisher intent. ## v1.16.0 - 2026-01-28 ### Changed - Upgraded `@canva/app-middleware` to `0.0.0-beta.5`. ## v1.15.0 - 2026-01-21 ### Added - A template for the new Content Publisher intent ### Changed - Replaced `jwt_middleware` util with `@canva/app-middleware` SDK. - Upgraded `@canva/app-ui-kit` to `5.5.0`. - Upgraded `@canva/platform` to `2.2.1`. - Upgraded `@canva/error` to `2.2.0`. ## v1.14.0 - 2026-01-14 ### Changed - Removed `asset` import alias for generated templates since it's not used in any of our examples. - Dependencies audit bringing modules up to date: ```text @modelcontextprotocol/sdk 1.17.4 -> 1.25.2 systeminformation 5.27.8 -> 5.27.14 ``` ## v1.13.0 - 2026-01-07 ### Added - Added `apps link` command to connect a project directory to a Canva app by setting the required ENV variables. - Update doctor command to also check for newly released `@canva/app-middleware` package. ### Changed - Cleanup unnecessary `utils` alias in the generated template webpack config. - Upgraded `@canva/user` to `2.1.2`. - Upgraded `@canva/app-ui-kit` to `5.4.0`. - Upgraded `react` and `react-dom` to `19.2.3`. - Upgraded `@canva/asset` to `2.3.0`. ### Fixed - Fixed `canva apps list` command not loading any more than 25 apps. ## v1.12.0 - 2025-12-15 ### Added - Add Real Estate MLS app to templates - Added JWT verification middleware to DAM and GenAI templates. ### Changed - It's that time of year again! Updating the CLI logo to be Christmas themed! - Upgraded `@canva/design` to `v2.7.5`. - Updated `react` and `react-dom` to `19.2.1`. - Upgraded `@canva/app-i18n-kit` to `1.2.0`. - Upgraded `@canva/app-ui-kit` to `5.3.0`. - Upgraded `@canva/asset` to `2.2.2`. - The `utils/backend` folder is no longer included in the output of templates that don't require a backend. - Moved backend utility modules from `/utils` to `/backend`. ### Fixed - Updated intent setup instructions in the data connector template README.md - Fixed missing permission in the DAM template's `canva-app.json`. - Cleanup orphaned auth router code and utils from `gen_ai` template. ## v1.11.0 - 2025-12-08 ### Changed - Updated all app templates to use intents and put prepare statements in src/intents/[intent]/index.tsx - Updated the [design editor intent migration](https://www.canva.dev/docs/apps/upgrades-and-migrations/design-editor-migration-guide/) to move code into a new `src/intents/design_editor` structure - Updated `canva apps preview` command to support selecting between multiple intents. - Replaced the usage of `use_add_element` hook in app templates with a more accurate inline implementation. - Replaced the usage of React utility hooks from `utils` directory in app templates with our brand new [@canva/app-hooks](https://www.npmjs.com/package/@canva/app-hooks) SDK. - Updated v2 sdk codemod to import `useFeatureSupport` hook from `@canva/app-hooks` instead of pasting its source code. - Updated apps sdk v2 codemod to better handle feature support for element adding. - Updated the intents check for the apps doctor command to support the recommended intent code structure. ## v1.10.0 - 2025-11-19 ### Changed - Make `tsconfig` stricter to increase runtime type safety. ### Fixed - Removed incorrect `node_modules/@types/` include from tsconfig.json. ## v1.9.0 - 2025-11-13 ### Added - Clarified preview app link text to indicate clear CTA ### Changed - Set `moduleResolution` to `bundler`, enabled `esModuleInterop`, and updated necessary import statements for app templates. - Updated `@canva/app-ui-kit` to version `5.2.1`. - Consolidated the MCP migration tools into a single tool ## v1.8.0 - 2025-10-30 ### Changed - Private app creation is now limited to Enterprise plan users only. - Updated `canva apps create` to prompt for a new name if a local directory already exists with the same name. ### Fixed - Updated `copy_env.ts` script to not throw if a template .env file does not exist ## v1.7.0 - 2025-10-23 ### Changed - Updated `@canva/app-ui-kit` to `v5.2.0` across all templates. - Updated app-ui-kit-v5 migration to always install the latest compatible packages. ### Fixed - Removed source code test files from being included in CLI templates. ## v1.6.0 - 2025-10-22 ### Added - Add `design-editor-intent` migration for updating apps to the design editor intent pattern. ## v1.5.2 - 2025-10-20 ### Fixed - Fixed some UI issues in the DAM template by updating `@canva/app-components` to `v2.1.0`. ## v1.5.1 - 2025-10-16 ### Fixed - Updated `react` dependencies to use ^ (compatible with) across all templates to reduce the impact of `@canva package` updates with react peer dependencies. ## v1.5.0 - 2025-10-15 ### Changed - Update `testRegex` in jest config to include `__tests__` - Updated @canva/app-ui-kit to 5.1.0 and React to 19.2.0. - Upgraded @canva/app-eslint-plugin to 1.0.0-beta.7. - Updated `@canva/design` from `2.7.2` to `2.7.3` across templates. ### Fixed - Minor improvements to the Data Connector README. - Fixed a bug that causes app build to break when `BACKEND_HOST` is undefined. ## v1.4.0 - 2025-10-09 ### Added - Add migrate instructions to the Canva Dev MCP ### Fixed - Updated @canva/app-ui-kit to v5.0.2 to incorporate a bug fix and updated tokens. ## v1.3.0 - 2025-10-01 ### Added - Added a new apps migration for upgrading to App UI Kit v5 and React v19 ### Changed - Updated app templates to use App UI Kit v5 and React v19 - Updated to `ink` v6.3.1. ## v1.2.0 - 2025-09-14 ### Added - Added `canva apps migrate` command to run code migrations for updating apps to newer patterns and APIs. - Added Apps SDK v1 to v2 migration: `apps-sdk-v1-v2`. ### Changed - Updated the `canva apps doctor` command to check for legacy sdk directory usage. - The `canva login` command no longer requires manually copying and pasting an auth code. To use the old login flow, add the `--mode=manual` argument. ### Fixed - Updated the Data Connector template example to match recent changes in the Connect API spec. ## v1.1.0 - 2025-09-04 ### Added - Added type exports for `generatePreviewUrl`. ### Changed - Updated `@modelcontextprotocol/sdk` dependency to `1.17.4`. - Updated template READMEs to reflect the changes made to navigation structure in the developer portal. - Updated `@canva/app-eslint-plugin` to `1.0.0-beta.5` across all templates. ## v1.0.1 - 2025-08-25 ### Fixed - Fixed a circular dependency issue in the `data_connector` and `gen_ai` templates causing the app not to load. - A bug where the `gen_ai` template was not respecting the `canAcceptPayments` flag from the platform info. ## v1.0.0 - 2025-08-21 ### Added - Add a new `app config push|pull|status` command, to manage your app's Developer Portal manifest config locally. - Add a new `canva bug` command to start the Github issue creation flow. - Add `AGENTS.md` and `CLAUDE.md` support to CLI app creation process to provide instructions for AI agents such as Amp, Codex, Jules, etc... - Add an extra step to the app creation process to allow for optional IDE config files to be added or not. ```text ? Select optional configs to add to your project: (Use space to toggle, arrow keys to navigate) → [x] VS Code Settings - Add `.vscode` directory with editor settings and MCP setup [x] Cursor AI Settings - Add `.cursor` directory with Cursor AI editor and MCP configuration [x] AGENTS.md - Add AGENTS.md file with instructions for AI agents such as Amp, Codex, Jules, etc... [ ] CLAUDE.md - Add CLAUDE.md file with instructions for Claude Code ──────────────────────────────────────────────────────────── Continue (3 selected) Selected: VS Code Settings, Cursor AI Settings, AGENTS.md ```