Skip to content

Commit cbff9e7

Browse files
winter100004claude
andcommitted
docs(sdk-install): self-hosted bundle serving — ASSETS_URI is the serve ROOT, not the version dir
A locally built bundle (apps/sdk/dist) nests files under /<version>/<target>/; pointing ASSETS_URI at that inner directory 404s the loader. Spell out the serve-root semantics + USERTOURJS_BROWSER_TARGET, since this exact mistake has burned two debugging sessions. Bump 0.3.2. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent adf3a75 commit cbff9e7

7 files changed

Lines changed: 18 additions & 6 deletions

File tree

.agents/plugins/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"plugins": [
33
{
44
"name": "usertour",
5-
"version": "0.3.1",
5+
"version": "0.3.2",
66
"category": "Coding",
77
"source": {
88
"type": "local",

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
"name": "usertour",
1111
"source": "./",
1212
"description": "Skills for authoring Usertour in-app onboarding content",
13-
"version": "0.3.1"
13+
"version": "0.3.2"
1414
}
1515
]
1616
}

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "usertour",
33
"description": "Skills for Usertour in-app onboarding — authoring content (flows, checklists, launchers, banners, surveys) and installing the Web SDK — via the Usertour API/MCP",
4-
"version": "0.3.1",
4+
"version": "0.3.2",
55
"author": {
66
"name": "Usertour",
77
"url": "https://www.usertour.io"

.codex-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "usertour",
3-
"version": "0.3.1",
3+
"version": "0.3.2",
44
"description": "Skills for Usertour in-app onboarding — authoring content (flows, checklists, launchers, banners, surveys) and installing the Web SDK — via the Usertour API/MCP",
55
"author": {
66
"name": "Usertour",

.cursor-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
"name": "usertour",
1010
"source": "./",
1111
"description": "Skills for authoring Usertour in-app onboarding content",
12-
"version": "0.3.1"
12+
"version": "0.3.2"
1313
}
1414
]
1515
}

.cursor-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "usertour",
3-
"version": "0.3.1",
3+
"version": "0.3.2",
44
"description": "Skills for Usertour in-app onboarding — authoring content (flows, checklists, launchers, banners, surveys) and installing the Web SDK — via the Usertour API/MCP",
55
"author": {
66
"name": "Usertour",

skills/usertour-sdk-install/references/self-hosted.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,18 @@ deployment (e.g. your app on `app.example.com`, Usertour on
3434
<!-- then the loader + usertour.init("<environment token>") -->
3535
```
3636

37+
That is the COMPLETE key set the loader/SDK reads, plus one more:
38+
`USERTOURJS_BROWSER_TARGET` (`"es2020"` | `"legacy"`) force-picks a bundle
39+
instead of the loader's user-agent sniff — only needed when the sniff guesses
40+
wrong (exotic webviews).
41+
42+
**Serving a locally BUILT bundle (apps/sdk/dist)?** The dist layout carries a
43+
version layer — `/<version>/es2020/usertour.js` — and the bundle's baked-in CSS
44+
path expects `ASSETS_URI` to be the serve ROOT (it appends
45+
`/<version>/<target>/css/index.css` itself). Pointing `ASSETS_URI` at the
46+
target folder double-nests the path → CSS 404s → widgets render 0×0 with no
47+
error (this exact mistake has burned two debugging sessions).
48+
3749
Confirm the exact key names + which are required against the docs above.
3850

3951
## Local dev vs full self-host — don't over-configure

0 commit comments

Comments
 (0)