From 26e5a4f485a475102fc6904a14f4257eb7f17f4b Mon Sep 17 00:00:00 2001 From: Tjeerd Stap <64895800+ThisIsTJ@users.noreply.github.com> Date: Wed, 2 Sep 2026 10:22:02 -0700 Subject: [PATCH] Make `local` an explicit `baseUrl` exception `baseUrl` must equal `//` was written as an absolute, and four of the five repos broke it: their `local` targets use `baseUrl: "/"` against a `-workshop-local` app name. Only `workshop-ixp` complied, at `/ixp-workshop-local/`. The four were right and the rule was overstated. It exists so a build and a deploy cannot disagree about where assets live -- Docusaurus compiles `baseUrl` into every asset path and the app is served at `//`. `local` is never deployed, so there is no deploy to disagree with, and `/` is what makes `npm run start` serve at the root of localhost. The rule now binds hosted targets and names `local` as the exception. It also moves into its own bullet: it was buried in the middle of the slug-budget arithmetic, which is a separate concern and read as an aside rather than a rule. `workshop-ixp` moves to `/` in its own repo so all five agree. Release v1.7.1. Co-Authored-By: Claude Opus 5 --- agents/base.md | 13 ++++++++++--- package.json | 2 +- 2 files changed, 11 insertions(+), 4 deletions(-) diff --git a/agents/base.md b/agents/base.md index cf5df97..ad64746 100644 --- a/agents/base.md +++ b/agents/base.md @@ -51,10 +51,17 @@ change the convention here and roll it out everywhere. name. Note that the derived shape, `-`, predates the naming convention above and does not match it, so every current target sets `codedApp.name` explicitly. +- **`baseUrl` equals `//` on every hosted target.** The two always + move together: Docusaurus compiles `baseUrl` into every asset path and the app is + served at `//`, so a build and a deploy that disagree give you a site where + every asset 404s. Renaming a hosted app is therefore also a `baseUrl` change, a + new participant URL, and a redeploy. The `local` target is the one exception -- + it keeps `baseUrl: "/"` so `npm run start` serves at the root of `localhost`. + That is safe because `local` is never deployed, and the rule exists only to stop + a build and a deploy from disagreeing. - **Keep the product slug to 15 characters.** - `uip codedapp deploy` rejects a name over 32 characters, and `baseUrl` must - always equal `//`, so the two move together. `-workshop-` spends - 10 characters, leaving 22 to share between the slug and the target name. A + `uip codedapp deploy` rejects a name over 32 characters, and `-workshop-` already + spends 10 of them, leaving 22 to share between the slug and the target name. A 15-character slug therefore leaves 7 for the target, which covers `local`, `growth` and the retired `staging`; `case-management-workshop-staging` is exactly 32. Abbreviate in the slug rather than the fixed part -- `comms-mining`, not diff --git a/package.json b/package.json index ae7aff5..aaf0d59 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@uipath-lab-tec/workshop-kit", - "version": "1.7.0", + "version": "1.7.1", "description": "Shared Docusaurus infrastructure for UiPath LAB TEC workshop repos.", "license": "UNLICENSED", "type": "module",