webflow-code-component:local-dev-setup — скилл для Claude Code
Скилл webflow-code-component:local-dev-setup создаёт проект Webflow Code Components с нуля: структуру, зависимости, webflow.json и стартовый компонент.
MIT 1 000 установок ★ 137 обновлён 2026-10-22
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a claude-codeЧто делает webflow-code-component:local-dev-setup
Скилл проходит по проекту в пять фаз. Сначала смотрит, что уже есть: package.json, webflow.json, текущая структура. Потом решает, новый это проект или Code Components добавляются в существующий React-проект — Next.js и Vite тоже упоминаются.
Дальше создаёт структуру, ставит зависимости и настраивает конфиги. В webflow.json прописываются имя библиотеки и glob-паттерн для компонентов, в tsconfig.json включается JSX. В конце добавляется пример компонента Button и опциональный файл глобалов.
Проверка сборки идёт через npx webflow library bundle --public-path http://localhost:4000/. Полноценное тестирование в Webflow Designer требует деплоя командой npx webflow library share — локальная проверка не покрывает всё. Нужны Node.js 18+, React 18+, TypeScript и @webflow/webflow-cli.
Какие задачи решает
- создать структуру нового проекта Code Components с нуля
- подключить Webflow Code Components к существующему React-проекту
- настроить webflow.json с glob-паттерном для компонентов
- собрать бандл локально и поймать ошибки до деплоя
- получить стартовый компонент Button с определением и стилями
Примеры запросов агенту
- Создай новый проект Webflow Code Components в этой папке
- Добавь Code Components в мой существующий React-проект
- Настрой окружение для разработки компонентов Webflow и проверь, что бандл собирается
Как установить webflow-code-component:local-dev-setup
1Через Skills CLI (Vercel)
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a claude-code2Вручную: положить файлы
~/.claude/skills/local-dev-setup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/local-dev-setup/
1Через Skills CLI (Vercel)
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a codex2Вручную: положить файлы
.agents/skills/local-dev-setup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a cursor2Вручную: положить файлы
.cursor/skills/local-dev-setup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install webflow/webflow-skills plugins/webflow-skills/skills/local-dev-setup2Вручную: положить файлы
.github/skills/local-dev-setup/SKILL.md1Через Skills CLI (Vercel)
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a gemini-cli2Командой платформы
gemini skills install https://github.com/webflow/webflow-skills --path plugins/webflow-skills/skills/local-dev-setupВручную: положить файлы
.devin/skills/local-dev-setup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о webflow-code-component:local-dev-setup
Как установить webflow-code-component:local-dev-setup в Claude Code?
Выполни npx skills add webflow/webflow-skills --skill webflow-code-component:local-dev-setup -a claude-code. Файл скилла появится в ~/.claude/skills/local-dev-setup/SKILL.md.
Что делает этот скилл?
Инициализирует проект Webflow Code Components: создаёт структуру папок, ставит React, TypeScript и @webflow/webflow-cli, настраивает webflow.json и tsconfig.json, добавляет пример компонента Button.
Что нужно для работы скилла?
Node.js 18+, React 18+, TypeScript и пакеты @webflow/webflow-cli, @webflow/data-types, @webflow/react. Без @webflow/webflow-cli локальная сборка бандла не запустится.
Исходный текст
SKILL.md · MIT
---
name: webflow-code-component:local-dev-setup
description: Initialize a new Webflow Code Components project from scratch. Creates project structure, installs dependencies, configures webflow.json, and sets up development environment.
compatibility: Node.js 18+, React 18+, TypeScript, @webflow/webflow-cli
metadata:
author: webflow
version: "1.1"
---
# Local Dev Setup
Set up a new Webflow Code Components project from scratch.
## When to Use This Skill
**Use when:**
- Starting a brand new code components project
- User asks to set up, initialize, or create a new project
- Adding code components to an existing React project
- Setting up the development environment for the first time
**Do NOT use when:**
- Project already exists and is configured (just answer questions directly)
- Creating individual components (use component-scaffold instead)
- Deploying components (use deploy-guide instead)
## Instructions
### Phase 1: Assess Current State
1. **Check if project exists**:
- Is there an existing package.json?
- Is there an existing webflow.json?
- What's the current project structure?
2. **Determine setup type**:
- New project from scratch
- Add to existing React project
- Add to existing Next.js/Vite project
### Phase 2: Project Initialization
3. **Create project structure** (if new):
- Initialize npm project
- Set up TypeScript
- Create folder structure
4. **Install dependencies**:
- Core: React, TypeScript
- Webflow: CLI, data-types, react utils
- Optional: Styling libraries
### Phase 3: Configuration
5. **Create webflow.json**:
- Set library name
- Configure component glob pattern
- Set up globals if needed
6. **Configure TypeScript**:
- Set up tsconfig.json
- Enable JSX support
### Phase 4: Create Starter Files
7. **Create example component**:
- Simple Button component
- Definition file
- Basic styling
8. **Create globals file** (optional):
- For shared styles
- For decorators
### Phase 5: Verify Setup
9. **Verify bundle compiles**:
- Run `npx webflow library bundle --public-path http://localhost:4000/` to catch build errors locally
- This verifies your components, imports, and configuration are correct
- Full testing in the Webflow Designer requires deploying with `npx webflow library share`
10. **Provide next steps**:
- How to create more components
- How to deploy
- Development workflow
## Examples
For detailed step-by-step examples, see [references/EXAMPLES.md](references/EXAMPLES.md).
**Available examples:**
1. **New Project from Scratch** - Complete setup with React, TypeScript, and CSS Modules
2. **Add to Existing React Project** - Integrate code components into an existing codebase
3. **With Tailwind CSS** - Setup with Tailwind CSS support
**Quick Start (New Project):**
```bash
# 1. Create project
mkdir my-webflow-components && cd my-webflow-components
npm init -y
# 2. Install dependencies
npm install react react-dom
npm install -D typescript @types/react @types/react-dom
npm install -D @webflow/webflow-cli @webflow/data-types @webflow/react
# 3. Create webflow.json
echo '{"library":{"name":"My Library","components":["./src/**/*.webflow.tsx"]}}' > webflow.json
# 4. Create component directory
mkdir -p src/components/Button
```
Then create your component files (.tsx, .webflow.tsx, .module.css). See Example 1 in [references/EXAMPLES.md](references/EXAMPLES.md) for complete file contents including component, definition, and CSS files.
Deploy with:
```bash
npx webflow library share
```
## Validation
After setup, verify the project is correctly configured:
| Check | How to Verify |
|-------|---------------|
| `webflow.json` exists in project root | `cat webflow.json` |
| Dependencies installed | `npm list @webflow/webflow-cli` |
| Bundle compiles without errors | `npx webflow library bundle --public-path http://localhost:4000/` |
| At least one component found | Check bundle output for "Found N component(s)" |
## Guidelines
### Minimum Requirements
Every code components project needs:
1. **package.json** with dependencies
2. **webflow.json** with library config
3. **tsconfig.json** (for TypeScript)
4. At least one `.webflow.tsx` file
### Recommended Structure
```
project/
├── src/
│ ├── components/
│ │ └── [ComponentName]/
│ │ ├── [ComponentName].tsx
│ │ ├── [ComponentName].webflow.tsx
│ │ └── [ComponentName].module.css
│ ├── hooks/ # Custom hooks
│ ├── utils/ # Utilities
│ ├── declarations.d.ts # CSS module types
│ ├── globals.ts # Decorators/global imports
│ └── globals.css # Global styles
├── package.json
├── tsconfig.json
├── webflow.json
└── .gitignore
```
### Development Workflow
1. **Create component**: Use [component-scaffold](../component-scaffold/SKILL.md) skill
2. **Develop locally**: Run React project to iterate (e.g., `npm run dev`)
3. **Validate**: Use [pre-deploy-check](../pre-deploy-check/SKILL.md) skill
4. **Deploy**: Use [deploy-guide](../deploy-guide/SKILL.md) skill or run `npx webflow library share`
5. **Test in Webflow**: Add component to page in Designer
© webflow · MIT · webflow/webflow-skills