From webflow-code-component-skills
Guides deployment of Webflow Code Components to workspaces via Webflow CLI. Covers pre-flight checks, authentication, execution, and verification. Use for publish/deploy requests.
npx claudepluginhub webflow/webflow-skills --plugin webflow-code-component-skillsThis skill uses the workspace's default tool permissions.
Guide users through deploying their code component library to Webflow.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Guide users through deploying their code component library to Webflow.
Use when:
Do NOT use when:
Note: The CLI command is webflow library share. This skill uses "deploy" as the user-facing term.
Verify project is ready:
Check authentication status:
Confirm deployment target:
npx webflow library shareVerify deployment:
Provide next steps:
๐ฆ Deploying Code Components
Step 1: Pre-flight checks
โโโ webflow.json โ
โโโ Dependencies โ
โโโ Build test โ
Step 2: Authentication
โโโ Checking for existing auth...
โโโ Found valid token โ
Step 3: Deploying
โโโ Bundling components...
โโโ Uploading to workspace...
โโโ Processing...
Step 4: Verification
โโโ Library registered โ
โโโ 4 components available โ
๐ Deployment Complete!
# Set environment variable
export WEBFLOW_WORKSPACE_API_TOKEN=your-token-here
# Deploy without prompts
npx webflow library share --no-input
User prompt:
Deploy my components to Webflow
Response:
๐ Deploy Guide: Code Components
Let me guide you through deploying your component library.
---
## Step 1: Pre-Flight Checks
Running validation...
โ
webflow.json configured
โ
Dependencies installed
โ
Build succeeds
โ
Bundle size: 2.3MB (under 50MB limit)
All checks passed! Ready to deploy.
---
## Step 2: Authentication
**Option A: Interactive (Recommended for first time)**
Run the deploy command:
```bash
npx webflow library share
This will:
Option B: API Token (For CI/CD or returning users)
Get your Workspace API Token:
Run with token:
npx webflow library share --api-token YOUR_TOKEN_HERE
Or set environment variable:
export WEBFLOW_WORKSPACE_API_TOKEN=YOUR_TOKEN_HERE
npx webflow library share
Ready to deploy? Run:
npx webflow library share
Expected output:
โ Bundling components...
โ Authenticating...
โ Uploading library...
โ Processing...
Library "My Component Library" successfully shared!
Components:
- Button
- Card
- Accordion
- Modal
View in Designer: Open any site in your workspace
After deployment:
โ Your components are live!
To update components later:
# Make your changes, then re-deploy
npx webflow library share
Important notes:
๐ก Tips:
--verbose flag for debugging issuesnpx webflow library log to see recent deploy logs
---
**Example: First-Time Setup**
๐ Deploy Guide: First-Time Setup
I see this is your first deployment. Let me walk you through the full setup.
You'll need a Workspace API token to deploy:
Open Webflow Dashboard Go to webflow.com and log in
Navigate to Workspace Settings Click your workspace name โ Settings
Find API Access Go to "Apps & Integrations" โ "Manage"
Generate Token Under "Workspace API Access":
Save Token Add to your .env file:
WEBFLOW_WORKSPACE_API_TOKEN=your-token-here
โ ๏ธ Add .env to .gitignore:
echo ".env" >> .gitignore
Now run:
npx webflow library share
The CLI will:
After successful deploy:
๐ First deployment complete!
Future deployments are simpler:
# Just run this after making changes
npx webflow library share
---
**Example: CI/CD Setup**
๐ Deploy Guide: CI/CD Setup
Setting up automated deployments for your pipeline.
Create .github/workflows/deploy.yml:
name: Deploy to Webflow
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
- name: Install dependencies
run: npm ci
- name: Deploy to Webflow
env:
WEBFLOW_WORKSPACE_API_TOKEN: ${{ secrets.WEBFLOW_WORKSPACE_API_TOKEN }}
run: npx webflow library share --no-input
WEBFLOW_WORKSPACE_API_TOKENnpx webflow library share --no-input
--no-input: Disables interactive promptsWEBFLOW_WORKSPACE_API_TOKEN env var automatically- name: Type check
run: npx tsc --noEmit
โ CI/CD configured!
Now every push to main will automatically deploy your components.
## Validation
After deployment, verify success with these checks:
| Check | How to Verify |
|-------|---------------|
| Deploy completed | `npx webflow library share` exited without errors |
| Components visible | Open Designer Add panel โ find your library |
| Import logs clean | `npx webflow library log` shows successful import |
| Bundle size OK | Output shows bundle under 50MB |
| Props work | Drag component onto canvas, verify props in right panel |
## Guidelines
### Terminology
The CLI command is `webflow library share`. This skill uses "deploy" as the user-facing term for consistency with common developer vocabulary. See the [CLI reference](../../references/CODE_COMPONENTS_REFERENCE.md) (Section 12) for full command documentation.
### Authentication Methods
| Method | Use Case | Command |
|--------|----------|---------|
| Interactive | First time, local dev | `npx webflow library share` |
| Environment variable | CI/CD, automation | Set `WEBFLOW_WORKSPACE_API_TOKEN` |
| CLI flag | One-off with different token | `--api-token TOKEN` |
### Pre-Deploy Checklist
Before every deployment:
- [ ] `npm install` is up to date
- [ ] Build succeeds locally
- [ ] Bundle under 50MB
- [ ] All component tests pass
- [ ] No SSR-breaking code (or ssr: false set)
- [ ] Props have default values where supported (not available for Link, Image, Slot, ID)
### Common Deploy Issues
| Issue | Cause | Solution |
|-------|-------|----------|
| "Authentication failed" | Invalid/expired token | Regenerate workspace token |
| "Bundle too large" | Over 50MB | Optimize dependencies |
| "Library not found" | Wrong workspace | Check token workspace |
| "Build failed" | Code errors | Fix compilation errors |
### CLI Flags Reference
All flags for `npx webflow library share`:
| Flag | Description | Default |
|------|-------------|---------|
| `--manifest` | Path to `webflow.json` file | Scans current directory |
| `--api-token` | Workspace API token | Uses `WEBFLOW_WORKSPACE_API_TOKEN` from `.env` |
| `--no-input` | Skip interactive prompts (for CI/CD) | No |
| `--verbose` | Display more debugging information | No |
| `--dev` | Bundle in development mode (no minification) | No |
### Rollback & Versioning
- Each `library share` replaces the **entire** library โ there are no partial updates
- There is **no built-in rollback** โ use git to revert changes and re-deploy
- **Never rename `.webflow.tsx` files** โ renaming creates a new component and removes the old one, breaking all existing instances in projects
### Debugging Commands
```bash
# Check recent deploy logs
npx webflow library log
# Verbose deploy output (detailed errors)
npx webflow library share --verbose
# Local bundle verification (catches build errors before deploying)
npx webflow library bundle --public-path http://localhost:4000/
The GitHub Actions example above applies to any CI system. The key elements are:
# Generic CI pattern:
npm ci # Install dependencies
npx webflow library share --no-input # Deploy without prompts
# Requires WEBFLOW_WORKSPACE_API_TOKEN env var
Always verify after deployment: