@webflow/webflow-cli 1.6.2 → 1.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # @webflow/webflow-cli
2
2
 
3
+ ## 1.6.3
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated README
8
+
3
9
  ## 1.6.2
4
10
 
5
11
  ### Minor Changes
package/README.md CHANGED
@@ -1,25 +1,67 @@
1
1
  # Webflow CLI
2
2
 
3
- ## Install
3
+ The Webflow CLI is a command-line interface that allows you to interact with various Webflow developer products, including Devlink and Designer Extensions.
4
+
5
+ ## Installation
6
+
7
+ You can install the Webflow CLI globally on your machine using npm:
4
8
 
5
9
  ```shell
6
- npm i @webflow/webflow-cli
10
+ npm i @webflow/webflow-cli -g
7
11
  ```
8
12
 
9
- ## Usage
13
+ # Usage
14
+
15
+ - [Webflow Designer APIs & Extensions](#webflow-designer-apis-and-extensions)
16
+ - [Devlink](#devlink)
17
+
18
+ ## Webflow Designer Extensions and APIs
19
+ [Designer Extensions](https://docs.developers.webflow.com/v2.0.0/docs/apps-overview) are single-page web Apps that run inside of of the Webflow Designer, and manipulate elements on the canvas through [Webflow's Designer APIs.](https://docs.developers.webflow.com/v2.0.0/reference/introduction-1). You can use the Webflow CLI to develop and package your Designer Extensions.
10
20
 
21
+ ### Creating an Extension
22
+ To create a new extension, use the `webflow extension init` command:
23
+
24
+ ```shell
25
+ webflow extension init my-extension
26
+ ```
27
+
28
+ This command creates a new directory named `my-extension` with a basic scaffold for your extension. See more details about the scaffolding on the [App structure reference](https://docs.developers.webflow.com/v2.0.0/reference/app-structure).
29
+
30
+ ### Running your Extension Locally
31
+
32
+ Navigate to the newly created folder for your extension. You can serve your extension locally using the following command. The default port is set to 1337.
33
+
34
+ ```shell
35
+ npm run dev
36
+ ```
37
+ This will run the `webflow extension serve` and command, allowing you test your App locally.
38
+
39
+ ### Building and Bundling your Extension
40
+
41
+ If you're using the scaffolding built out from the `webflow extension init` command, you can create a build of your extension, an bundle it for publishing using the` npm run build` command:
42
+
43
+ ```shell
44
+ npm run build
45
+ ```
46
+
47
+ This will run the `webflow extension bundle` CLI command, which will output a `bundle.zip` file in your extension’s directory. You can upload this extension to Webflow via the "Integrations" tab in your workspace settings. Note: The extension size limit is 5MB.
48
+
49
+ # Devlink
50
+
51
+ DevLink allows you to visually design and build web components for React directly in Webflow. [Learn more in our DevLink overview,](https://webflow.com/devlink) and read the [DevLink documentation](https://docs.developers.webflow.com/docs/devlink-documentation-and-usage-guide).
11
52
 
12
- ### DevLink
13
53
  ```shell
14
54
  npx webflow devlink -h
15
55
  ```
16
56
 
17
- In order to use the DevLink CLI first you'll need to create a `.webflowrc` configuration file on your application's root directory.
18
- The supported formats are JavaScript(.js) and JSON (.json).
57
+ In order to use the DevLink CLI first you'll need to create a `.webflowrc` configuration file on your application's root directory.
58
+
59
+ The supported formats are JavaScript(.js) and JSON (.json).
19
60
 
20
61
  It should look something like this:
21
62
 
22
63
  JSON:
64
+
23
65
  ```json
24
66
  {
25
67
  "host": "https://api.wfdev.io:8443",
@@ -30,6 +72,7 @@ JSON:
30
72
  ```
31
73
 
32
74
  JavaScript:
75
+
33
76
  ```js
34
77
  module.exports = {
35
78
  host: "https://api.wfdev.io:8443",
@@ -49,4 +92,5 @@ npx webflow devlink sync
49
92
  ```
50
93
 
51
94
  # Terms of Service
95
+
52
96
  By using Webflow DevLink you agree to the [Webflow Labs Terms of Service](https://webflow.com/legal/labs-terms).