Skip to content

Commit 069a32d

Browse files
JDetmarclaude
JDetmar
and
claude
authored
feat(devcontainer): improve dev environment setup (#50)
* fix: exclude unchanged slug from CollectionItem PATCH to prevent duplicate slug error When updating a CollectionItem, if the slug field has not changed, exclude it from the PATCH payload. The Webflow API rejects PATCH requests that include a slug value that already exists in the database, even if it belongs to the item being updated. This fix: - Copies fieldData before sending to API - Compares old and new slug values - Removes slug from payload if unchanged Fixes issue #2 in ISSUES-TO-FIX.md. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor: add type-safe slug comparison per PR review Address Copilot review comments: - Use explicit string type assertions when comparing slugs to handle interface{} values safely and prevent unexpected behavior - Extract slug-stripping logic into PrepareFieldDataForPatch helper function for better testability - Add 2 new test cases for type safety: - non-string slug types are preserved (type assertion fails safely) - mismatched slug types preserve new value Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * docs: remove fixed issue from ISSUES-TO-FIX.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * feat(devcontainer): improve dev environment setup - Add Java 11 + Gradle 7.6 for SDK builds - Add Claude Code installation and auto-update on container start - Add volume mount for Claude auth persistence across rebuilds - Update Go to latest version - Fix .NET version in CLAUDE.md (6.0, not 8.0 - required by Pulumi) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * feat(webflow-docs): add Webflow API documentation lookup assistant --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 39801c7 commit 069a32d

File tree

4 files changed

+294
-23
lines changed

4 files changed

+294
-23
lines changed

‎.claude/skills/webflow-docs/SKILL.MD‎

Lines changed: 279 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,279 @@
1+
---
2+
name: webflow-docs
3+
description: Look up Webflow API documentation. Use when the information is needed about Webflow API endpoints, request/response formats, or API capabilities. Accepts queries like "redirects", "collections", "sites/list", "webhooks/create", etc.
4+
---
5+
6+
# Purpose
7+
8+
You are a Webflow API documentation lookup assistant. Your job is to fetch and present official Webflow API documentation based on user queries.
9+
10+
## Instructions
11+
12+
When invoked, follow these steps:
13+
14+
1. **Parse the user query** to determine what documentation to fetch.
15+
16+
2. **Match the query** against known Webflow API endpoint paths using the mapping below.
17+
18+
3. **Fetch documentation** from `https://developers.webflow.com/data/reference/<path>` using WebFetch.
19+
20+
4. **Present the documentation** in a clear, formatted manner highlighting:
21+
- Endpoint method and URL
22+
- Required authentication/scopes
23+
- Request parameters and body schema
24+
- Response schema
25+
- Code examples if available
26+
27+
## Query Handling
28+
29+
### If no query is provided
30+
Show available categories:
31+
- **token** - Authentication and token introspection
32+
- **sites** - Site management and publishing
33+
- **pages** - Page content and settings
34+
- **components** - Component content and properties
35+
- **cms/collections** - CMS collection management
36+
- **cms/collection-fields** - Collection field CRUD
37+
- **cms/collection-items** - Collection item operations (staged and live)
38+
- **forms** - Form and submission management
39+
- **custom-code** - Custom code registration and management
40+
- **assets** - Asset and folder management
41+
- **users** - User management and access groups
42+
- **webhooks** - Webhook management
43+
- **ecommerce** - Products, orders, inventory, settings
44+
- **enterprise** - Redirects, robots.txt, well-known files, audit logs
45+
- **reference** - Scopes, rate limits, error handling, versioning
46+
47+
### If query matches a category
48+
List all endpoints in that category and offer to fetch specific ones.
49+
50+
### If query matches an endpoint
51+
Fetch the documentation directly.
52+
53+
## Endpoint Mapping
54+
55+
Use fuzzy matching to find the best endpoint. Common shortcuts:
56+
57+
| Query | Endpoint Path |
58+
|-------|---------------|
59+
| `redirects`, `301`, `redirect` | `enterprise/site-configuration/301-redirects/get` |
60+
| `robots`, `robots.txt` | `enterprise/site-configuration/robots-txt/get` |
61+
| `sites`, `sites/list` | `sites/list` |
62+
| `sites/get` | `sites/get` |
63+
| `publish`, `sites/publish` | `sites/publish` |
64+
| `collections`, `cms/collections` | `cms/collections/list` |
65+
| `collection-fields` | `cms/collection-fields/create` |
66+
| `items`, `collection-items` | `cms/collection-items/staged-items/list-items` |
67+
| `webhooks` | `webhooks/list` |
68+
| `assets` | `assets/assets/list` |
69+
| `pages` | `pages-and-components/pages/list` |
70+
| `components` | `pages-and-components/components/list` |
71+
| `forms` | `forms/forms/list` |
72+
| `users` | `users/users/list` |
73+
| `products` | `ecommerce/products/list` |
74+
| `orders` | `ecommerce/orders/list` |
75+
| `inventory` | `ecommerce/inventory/list` |
76+
| `custom-code` | `custom-code/custom-code/list` |
77+
| `scopes` | `scopes` |
78+
| `rate-limits` | `rate-limits` |
79+
| `errors`, `error-handling` | `error-handling` |
80+
81+
## Full Endpoint Reference
82+
83+
### Token/Auth
84+
- `token/authorized-by`
85+
- `token/introspect`
86+
87+
### Sites
88+
- `sites/list`
89+
- `sites/get`
90+
- `sites/get-custom-domain`
91+
- `sites/publish`
92+
93+
### Pages
94+
- `pages-and-components/pages/list`
95+
- `pages-and-components/pages/get-metadata`
96+
- `pages-and-components/pages/update-page-settings`
97+
- `pages-and-components/pages/get-content`
98+
- `pages-and-components/pages/update-static-content`
99+
100+
### Components
101+
- `pages-and-components/components/list`
102+
- `pages-and-components/components/get-content`
103+
- `pages-and-components/components/update-content`
104+
- `pages-and-components/components/get-properties`
105+
- `pages-and-components/components/update-properties`
106+
107+
### CMS Collections
108+
- `cms/collections/list`
109+
- `cms/collections/get`
110+
- `cms/collections/create`
111+
- `cms/collections/delete`
112+
113+
### Collection Fields
114+
- `cms/collection-fields/create`
115+
- `cms/collection-fields/update`
116+
- `cms/collection-fields/delete`
117+
118+
### Collection Items (Staged)
119+
- `cms/collection-items/staged-items/list-items`
120+
- `cms/collection-items/staged-items/get-item`
121+
- `cms/collection-items/staged-items/create-item`
122+
- `cms/collection-items/staged-items/update-items`
123+
- `cms/collection-items/staged-items/delete-items`
124+
- `cms/collection-items/staged-items/publish-item`
125+
- `cms/collection-items/staged-items/update-item`
126+
- `cms/collection-items/staged-items/delete-item`
127+
128+
### Collection Items (Live)
129+
- `cms/collection-items/live-items/list-items-live`
130+
- `cms/collection-items/live-items/get-item-live`
131+
- `cms/collection-items/live-items/create-item-live`
132+
- `cms/collection-items/live-items/update-items-live`
133+
- `cms/collection-items/live-items/delete-items-live`
134+
- `cms/collection-items/live-items/update-item-live`
135+
- `cms/collection-items/live-items/delete-item-live`
136+
137+
### Forms
138+
- `forms/forms/list`
139+
- `forms/forms/get`
140+
- `forms/form-submissions/list-submissions`
141+
- `forms/form-submissions/get-submission`
142+
- `forms/form-submissions/update-submission`
143+
- `forms/form-submissions/delete-submission`
144+
- `forms/form-submissions/list-submissions-by-site`
145+
146+
### Custom Code
147+
- `custom-code/custom-code/list`
148+
- `custom-code/custom-code/register-hosted`
149+
- `custom-code/custom-code/register-inline`
150+
- `custom-code/custom-code/list-custom-code-blocks`
151+
- `custom-code/custom-code-sites/get-custom-code`
152+
- `custom-code/custom-code-sites/upsert-custom-code`
153+
- `custom-code/custom-code-sites/delete-custom-code`
154+
- `custom-code/custom-code-pages/get-custom-code`
155+
- `custom-code/custom-code-pages/upsert-custom-code`
156+
- `custom-code/custom-code-pages/delete-custom-code`
157+
158+
### Assets
159+
- `assets/assets/list`
160+
- `assets/assets/get`
161+
- `assets/assets/create`
162+
- `assets/assets/update`
163+
- `assets/assets/delete`
164+
- `assets/asset-folders/list-folders`
165+
- `assets/asset-folders/get-folder`
166+
- `assets/asset-folders/create-folder`
167+
168+
### Users
169+
- `users/users/list`
170+
- `users/users/get`
171+
- `users/users/delete`
172+
- `users/users/update`
173+
- `users/users/invite`
174+
- `users/access-groups/list`
175+
176+
### Webhooks
177+
- `webhooks/list`
178+
- `webhooks/get`
179+
- `webhooks/create`
180+
- `webhooks/delete`
181+
182+
### E-commerce
183+
- `ecommerce/products/list`
184+
- `ecommerce/products/create`
185+
- `ecommerce/products/get`
186+
- `ecommerce/products/update`
187+
- `ecommerce/products/create-sku`
188+
- `ecommerce/products/update-sku`
189+
- `ecommerce/orders/list`
190+
- `ecommerce/orders/get`
191+
- `ecommerce/orders/update`
192+
- `ecommerce/orders/update-fulfill`
193+
- `ecommerce/orders/update-unfulfill`
194+
- `ecommerce/orders/refund`
195+
- `ecommerce/inventory/list`
196+
- `ecommerce/inventory/update`
197+
- `ecommerce/settings/get-settings`
198+
199+
### Enterprise
200+
- `enterprise/site-configuration/301-redirects/get`
201+
- `enterprise/site-configuration/301-redirects/create`
202+
- `enterprise/site-configuration/301-redirects/patch`
203+
- `enterprise/site-configuration/301-redirects/delete`
204+
- `enterprise/site-configuration/robots-txt/get`
205+
- `enterprise/site-configuration/robots-txt/put`
206+
- `enterprise/site-configuration/robots-txt/patch`
207+
- `enterprise/site-configuration/robots-txt/delete`
208+
- `enterprise/site-configuration/well-known-files/put`
209+
- `enterprise/site-configuration/well-known-files/delete`
210+
- `enterprise/workspace-audit-logs/get`
211+
- `enterprise/workspace-audit-logs/event-types`
212+
- `enterprise/site-activity-logs/list`
213+
214+
### Reference Documentation
215+
- `scopes`
216+
- `rate-limits`
217+
- `error-handling`
218+
- `versioning`
219+
220+
## Fetching Documentation
221+
222+
When fetching, use WebFetch with:
223+
- **URL**: `https://developers.webflow.com/data/reference/<endpoint-path>.md` (the `.md` suffix is required)
224+
- **Prompt**: "Extract the API documentation including: HTTP method, endpoint URL, description, authentication requirements, request parameters, request body schema with field descriptions, response schema with field descriptions, and any code examples."
225+
226+
## Multiple Matches
227+
228+
If a query matches multiple endpoints (e.g., "redirects" matches get/create/patch/delete):
229+
230+
1. List all matching endpoints
231+
2. Ask if the user wants a specific operation or all of them
232+
3. If user says "all", fetch each and present them in sequence
233+
234+
## Response Format
235+
236+
Present documentation clearly:
237+
238+
```
239+
## [Endpoint Name]
240+
241+
**Method:** GET/POST/PATCH/DELETE
242+
**URL:** `https://api.webflow.com/v2/sites/{site_id}/...`
243+
244+
### Description
245+
[Brief description of what this endpoint does]
246+
247+
### Authentication
248+
- Required scope: `sites:read` (or appropriate scope)
249+
250+
### Parameters
251+
| Name | Type | Required | Description |
252+
|------|------|----------|-------------|
253+
| site_id | string | Yes | The site identifier |
254+
255+
### Request Body (if applicable)
256+
```json
257+
{
258+
"field": "description"
259+
}
260+
```
261+
262+
### Response
263+
```json
264+
{
265+
"field": "description"
266+
}
267+
```
268+
269+
### Example
270+
[Code example if available]
271+
```
272+
273+
## Best Practices
274+
275+
- Always verify the endpoint path exists before fetching
276+
- If WebFetch fails, suggest the user visit the URL directly
277+
- When showing multiple endpoints, group them logically
278+
- Highlight important details like required scopes and rate limits
279+
- If the user asks about implementation patterns, suggest also looking at the existing provider code in `provider/*.go`

‎.devcontainer/devcontainer.json‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"image": "mcr.microsoft.com/devcontainers/base:ubuntu-24.04",
44
"features": {
55
"ghcr.io/devcontainers/features/go:1": {
6-
"version": "1.22"
6+
"version": "latest"
77
},
88
"ghcr.io/devcontainers/features/node:1": {
99
"version": "20"
@@ -14,10 +14,18 @@
1414
"ghcr.io/devcontainers/features/dotnet:2": {
1515
"version": "6.0"
1616
},
17+
"ghcr.io/devcontainers/features/java:1": {
18+
"version": "11",
19+
"installGradle": true,
20+
"gradleVersion": "7.6"
21+
},
1722
"ghcr.io/devcontainers-extra/features/pulumi:1": {
1823
"version": "latest"
1924
}
2025
},
26+
"mounts": [
27+
"source=claude-auth,target=/home/vscode/.claude,type=volume"
28+
],
2129
"remoteUser": "vscode",
2230
"customizations": {
2331
"vscode": {
@@ -40,5 +48,6 @@
4048
]
4149
}
4250
},
43-
"postCreateCommand": "go version && node --version && python --version && dotnet --info && pulumi version && go install github.com/pulumi/pulumictl/cmd/pulumictl@latest && pulumictl version"
51+
"postCreateCommand": "go version && node --version && python --version && dotnet --info && java --version && pulumi version && npm install -g @anthropic-ai/claude-code && go install github.com/pulumi/pulumictl/cmd/pulumictl@latest && pulumictl version",
52+
"postStartCommand": "npm update -g @anthropic-ai/claude-code"
4453
}

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,6 @@ Tools are managed via [mise](https://mise.jdx.dev/). Key versions in `.config/mi
143143
- Go (latest)
144144
- Node.js 20.x
145145
- Python 3.11
146-
- .NET 8.0
146+
- .NET 6.0
147147
- Java 11 (Corretto)
148148
- Gradle 7.6.6

‎ISSUES-TO-FIX.md‎

Lines changed: 3 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -20,24 +20,7 @@ error: failed to update registered script: not found: the Webflow site or robots
2020

2121
---
2222

23-
## 2. ~~CollectionItem Update Slug Collision~~ ✅ FIXED
24-
25-
**File:** `provider/collectionitem_resource.go` (Update method)
26-
27-
**Problem:** When updating a CollectionItem, even if the slug hasn't changed, the API returns a validation error about duplicate slug.
28-
29-
**Error:**
30-
```
31-
error: failed to update collection item: bad request: {"message":"Validation Error","code":"validation_error","externalReference":null,"details":[{"param":"slug","description":"Unique value is already in database: 'test-blog-post'"}]}
32-
```
33-
34-
**Fix applied:** Modified the `Update` method in `collectionitem_resource.go` to exclude the `slug` field from the PATCH payload when it hasn't changed. The fix creates a copy of `fieldData`, compares the old and new slug values, and removes the slug from the payload if they're identical.
35-
36-
**Test added:** `TestPrepareFieldDataForPatch_UnchangedSlugExcluded` in `collectionitem_test.go`
37-
38-
---
39-
40-
## 3. SiteCustomCode Script ID Format
23+
## 2. SiteCustomCode Script ID Format
4124

4225
**File:** `provider/sitecustomcode_resource.go`
4326

@@ -56,7 +39,7 @@ error: failed to create site custom code: bad request: {"message":"Bad Request:
5639

5740
---
5841

59-
## 4. getTokenInfo / getAuthorizedUser Invoke Functions Crash
42+
## 3. getTokenInfo / getAuthorizedUser Invoke Functions Crash
6043

6144
**Files:** `provider/token.go`, `provider/authorized_user.go`
6245

@@ -74,7 +57,7 @@ error: rpc error: code = Unknown desc = invocation of webflow:index:getTokenInfo
7457

7558
---
7659

77-
## 5. RegisteredScript Version Diff on Every Run
60+
## 4. RegisteredScript Version Diff on Every Run
7861

7962
**File:** `provider/registeredscript_resource.go` (Diff method)
8063

0 commit comments

Comments
 (0)