@webflow/webflow-cli 1.23.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @webflow/webflow-cli
 
+## 2.0.0
+
+### Major Changes
+
+- b0c1916: Raise the supported Node.js baseline to 22.13.0 for the CLI and repository tooling, and update CI coverage to Node 22, 24, and 25.
+
+### Minor Changes
+
+- 07650b5: - `cloud init --framework astro` now scaffolds **Astro 6** projects, sourced from the new `v2` branches on the existing [`Webflow-Examples/hello-world-astro`](https://github.com/Webflow-Examples/hello-world-astro/tree/v2) and [`hello-world-astro-devlink`](https://github.com/Webflow-Examples/hello-world-astro-devlink/tree/v2) repos. No version picker — users starting fresh always get the latest supported version. The Astro 5 scaffolds (`v1` branches on the same repos) remain frozen so older CLI installs continue to scaffold Astro 5.
+- `WEBFLOW_SITE_ID` env var is now uniformly **read-only**: the CLI uses it for the current command but never auto-persists it into `webflow.json`. To persist a site ID, run `webflow cloud init` or pass `--site-id` explicitly.
+- `webflow cloud init` prompts "New domain vs Existing site" in interactive mode (skipped only when `--new` is passed explicitly), and defaults to `New` in no-input mode (v1.x used to default to `Existing` here).
+- `webflow cloud create` now emits a deprecation warning for every install and will be removed in a future major release. Use `webflow cloud init` instead.
+- Deploy preflight always shows the "Pass --site-id explicitly or unset to see the deploy mode picker" hint when falling back to `WEBFLOW_SITE_ID`, and the no-identity error always lists both `--site-id` and `--workspace-id`.
+- c4fee62: Use `@webflow/react/server` as the server renderer for Code Components.
+
+### Patch Changes
+
+- b72178a: Refresh `webflow cloud` copy: command descriptions, option help, prompts, and error messages now consistently use "app" instead of "project" in favor of clearer language. No flag, command, or manifest field names changed — this is a copy-only update.
+- 2fd0d33: Migrate extension scaffolds to ESLint 9 with flat config (`eslint.config.mjs`), `typescript-eslint` v8, and updated lint scripts.
+- d91f805: Polish CLI formatting across commands
+- 953172d: Show deprecation warnings when using `webflow library share`, `webflow library bundle`, or `webflow library log`, including `[Deprecated]` hints in help text. Prefer `webflow devlink import`, `webflow devlink bundle`, and `webflow log`; the `library` command group will be removed in the next major release.
+- 8728f7c: Add deprecation note to "webflow devlink sync" command in help.
+- Updated dependencies [14c2ebc]
+  - @webflow/data-types@2.0.0
+
 ## 1.23.0
 
 ### Patch Changes

package/dist/cloud-scaffolds/registry.ts

@@ -32,7 +32,7 @@ export const FRAMEWORK_REGISTRY: Record<string, FrameworkDefinition> = {
     source: {
       type: "github",
       repo: "Webflow-Examples/hello-world-astro",
-      ref: "v1",
+      ref: "v2",
     },
   },
   "nextjs-minimal": {
@@ -50,7 +50,7 @@ export const FRAMEWORK_REGISTRY: Record<string, FrameworkDefinition> = {
     source: {
       type: "github",
       repo: "Webflow-Examples/hello-world-astro-devlink",
-      ref: "v1",
+      ref: "v2",
     },
   },
   nextjs: {

package/dist/extension-scaffolds/default/eslint.config.mjs

@@ -0,0 +1,39 @@
+import eslint from "@eslint/js";
+import promise from "eslint-plugin-promise";
+import tseslint from "typescript-eslint";
+
+/** Type-aware rules only run for sources included in tsconfig.json (see include). */
+const typeCheckedFiles = ["src/**/*.ts", "src/**/*.tsx"];
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked.map((config) => ({
+    ...config,
+    files: typeCheckedFiles,
+  })),
+  {
+    files: typeCheckedFiles,
+    plugins: {
+      promise,
+    },
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        { checksVoidReturn: false },
+      ],
+      "@typescript-eslint/no-unused-vars": "error",
+      "no-async-promise-executor": "error",
+      "require-await": "error",
+      "promise/catch-or-return": "error",
+    },
+  }
+);

package/dist/extension-scaffolds/default/package.json

@@ -6,15 +6,15 @@
   "scripts": {
     "build": "npm install && tsc -p tsconfig.json && webflow extension bundle",
     "dev": "npm install && concurrently -r \"webflow extension serve\" \"tsc -p tsconfig.json --watch --preserveWatchOutput\"",
-    "lint": "eslint . --ext .ts"
+    "lint": "eslint ."
   },
   "devDependencies": {
+    "@eslint/js": "^9.21.0",
     "@webflow/designer-extension-typings": "^2.0.2",
-    "@typescript-eslint/eslint-plugin": "^7.7.0",
-    "@typescript-eslint/parser": "^7.7.0",
-    "eslint": "^8.5.7",
     "concurrently": "^8.2.2",
-    "typescript": "^5.4.5",
-    "eslint-plugin-promise": "^6.1.1"
+    "eslint": "^9.21.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.24.0"
   }
 }

package/dist/extension-scaffolds/default/src/index.ts

@@ -6,7 +6,7 @@ const emojiMap = {
 };
 
 // default to smile
-let selectedEmoji = emojiMap.smile;
+let selectedEmoji: string = emojiMap.smile;
 addButtonListeners();
 
 document.getElementById("extension-form").onsubmit = async (event) => {
@@ -33,7 +33,7 @@ document.getElementById("extension-form").onsubmit = async (event) => {
 };
 
 // Check if specified style exists. If not, create a new style
-async function createOrUseStyle(styleName) {
+async function createOrUseStyle(styleName: string) {
   // Check if this style exists to avoid duplicate styles
   const style = await webflow.getStyleByName(styleName);
   if (style) {
@@ -47,7 +47,7 @@ async function createOrUseStyle(styleName) {
   }
 }
 
-function handleEmojiClick(emoji) {
+function handleEmojiClick(emoji: string) {
   selectedEmoji = emoji;
 }
 

package/dist/extension-scaffolds/default/tsconfig.json

@@ -4,5 +4,7 @@
     "target": "es6",
     "lib": ["es6", "dom"],
     "typeRoots": ["./node_modules/@types", "./node_modules/@webflow"]
-  }
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["node_modules"]
 }

package/dist/extension-scaffolds/react/eslint.config.mjs

@@ -0,0 +1,39 @@
+import eslint from "@eslint/js";
+import promise from "eslint-plugin-promise";
+import tseslint from "typescript-eslint";
+
+/** Type-aware rules only run for sources included in tsconfig.json (see include). */
+const typeCheckedFiles = ["src/**/*.ts", "src/**/*.tsx"];
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked.map((config) => ({
+    ...config,
+    files: typeCheckedFiles,
+  })),
+  {
+    files: typeCheckedFiles,
+    plugins: {
+      promise,
+    },
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        { checksVoidReturn: false },
+      ],
+      "@typescript-eslint/no-unused-vars": "error",
+      "no-async-promise-executor": "error",
+      "require-await": "error",
+      "promise/catch-or-return": "error",
+    },
+  }
+);

package/dist/extension-scaffolds/react/package.json

@@ -6,16 +6,17 @@
     "build": "npm run build-webpack && webflow extension bundle",
     "watch-webpack": "webpack --config webpack.config.mjs --mode development --watch",
     "build-webpack": "webpack --config webpack.config.mjs --mode production",
-    "lint": "eslint . --ext .ts,.tsx"
+    "lint": "eslint ."
   },
   "devDependencies": {
+    "@eslint/js": "^9.21.0",
     "@webflow/designer-extension-typings": "^2.0.2",
     "concurrently": "^8.2.2",
     "css-loader": "^7.1.2",
-    "eslint": "^8.5.7",
-    "@typescript-eslint/eslint-plugin": "^7.7.0",
-    "@typescript-eslint/parser": "^7.7.0",
-    "typescript": "^5.4.5",
+    "eslint": "^9.21.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.24.0",
     "react-dom": "^18.2.0",
     "react": "^18.2.0",
     "@types/react": "^18.2.79",
@@ -26,8 +27,7 @@
     "style-loader": "^4.0.0",
     "ts-loader": "^9.5.1",
     "webpack": "^5.89.0",
-    "webpack-cli": "^5.1.4",
-    "eslint-plugin-promise": "^6.1.1"
+    "webpack-cli": "^5.1.4"
   },
   "dependencies": {
     "react-dom": "^18.2.0"

package/dist/extension-scaffolds/react/src/index.tsx

@@ -23,7 +23,9 @@ const App: React.FC = () => {
   );
 };
 
-const root = ReactDOM.createRoot(
-  document.getElementById("root") as HTMLElement
-);
+const rootEl = document.getElementById("root");
+if (!rootEl) {
+  throw new Error('Could not find element with id "root"');
+}
+const root = ReactDOM.createRoot(rootEl);
 root.render(<App />);

package/dist/extension-scaffolds/typescript-alt/eslint.config.mjs

@@ -0,0 +1,39 @@
+import eslint from "@eslint/js";
+import promise from "eslint-plugin-promise";
+import tseslint from "typescript-eslint";
+
+/** Type-aware rules only run for sources included in tsconfig.json (see include). */
+const typeCheckedFiles = ["src/**/*.ts", "src/**/*.tsx"];
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked.map((config) => ({
+    ...config,
+    files: typeCheckedFiles,
+  })),
+  {
+    files: typeCheckedFiles,
+    plugins: {
+      promise,
+    },
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        { checksVoidReturn: false },
+      ],
+      "@typescript-eslint/no-unused-vars": "error",
+      "no-async-promise-executor": "error",
+      "require-await": "error",
+      "promise/catch-or-return": "error",
+    },
+  }
+);

package/dist/extension-scaffolds/typescript-alt/package.json

@@ -6,15 +6,15 @@
   "scripts": {
     "build": "npm install && tsc -p tsconfig.json && webflow extension bundle",
     "dev": "npm install && concurrently -r \"webflow extension serve\" \"tsc -p tsconfig.json --watch --preserveWatchOutput\"",
-    "lint": "eslint . --ext .ts"
+    "lint": "eslint ."
   },
   "devDependencies": {
+    "@eslint/js": "^9.21.0",
     "@webflow/designer-extension-typings": "^2.0.2",
-    "@typescript-eslint/eslint-plugin": "^7.7.0",
-    "@typescript-eslint/parser": "^7.7.0",
-    "eslint": "^8.5.7",
     "concurrently": "^8.2.2",
-    "typescript": "^5.4.5",
-    "eslint-plugin-promise": "^6.1.1"
+    "eslint": "^9.21.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.24.0"
   }
 }

package/dist/extension-scaffolds/typescript-alt/src/index.ts

@@ -1,4 +1,9 @@
-document.getElementById("lorem")!.onsubmit = async (event) => {
+const form = document.getElementById("lorem");
+if (!form) {
+  throw new Error('Could not find element with id "lorem"');
+}
+
+form.onsubmit = async (event) => {
   event.preventDefault();
   const el = await webflow.getSelectedElement();
   if (el && el.textContent) {

package/dist/extension-scaffolds/typescript-alt/tsconfig.json

@@ -4,5 +4,7 @@
     "target": "es6",
     "lib": ["es6", "dom"],
     "typeRoots": ["./node_modules/@types", "./node_modules/@webflow"]
-  }
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["node_modules"]
 }