@canva/cli 1.0.1 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+## v1.2.0 - 2025-09-15
+
+### 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
+  ```

package/README.md

@@ -90,7 +90,7 @@ To create a new app:
 
 ### Step 3: Preview your app
 
-When your new app is ready, the Canva CLI automatically opens the [Developer Portal](https://www.canva.com/developers/apps) to your new app's Configuration page in your browser. You can then continue to preview and manage your new app.
+When your new app is ready, the Canva CLI automatically opens the [Developer Portal](https://www.canva.com/developers/apps) to your new app's configuration page in your browser. You can then continue to preview and manage your new app.
 
 To preview your app:
 
@@ -204,6 +204,11 @@ canva login
 
 - **Flags**:
   - `--china`, `--cn`: Login to canva.cn, this will use canva.cn for all subsequent commands until you log out.
+  - `--mode`: The authentication mode or flow to use when logging in.
+
+    Available modes:
+    - `"callback"`: Runs a local server to receive the auth code (default).
+    - `"manual"`: Prompts you to copy and paste the auth code manually.
 
 #### logout
 
@@ -302,6 +307,27 @@ canva apps doctor
   - `--verbose`: Show detailed diagnostic output optimized for AI agent assistance.
   - `--check`: Specify a specific check to run.
 
+##### migrate
+
+Run specific code migrations to update your app to newer patterns and APIs.
+
+```shell
+canva apps migrate <migrationName>
+```
+
+- **Arguments**:
+  - `migrationName`: Name of the migration to run.
+
+    Available migrations:
+    - `"apps-sdk-v1-v2"`: Migrates apps using the Apps SDK v1 packages to v2.
+
+- **Examples**:
+
+  ```shell
+  canva apps migrate apps-sdk-v1-v2
+  canva apps migrate apps-sdk-v1-v2 --debug
+  ```
+
 ##### config
 
 Manage your [App Configuration](https://www.canva.dev/docs/apps/app-configuration/).