# Changelog

## 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
  ```
