Appearance
ADR 0003: Package and repo slugs without &
- Status: Accepted
- Date: 2026-11-18
- Spec version: 1.0.0
Context
The scaffold used the product name shoot&grow as the package name and workspace scope. & breaks npm scope names, URLs and some shells. It also broke the scaffold itself: about 30 generated files contained the HTML-escaped form shoot&grow, so imports such as @shoot&grow/ui/... could not resolve, and apps/web/package.json listed the same dependency twice under two spellings.
Decision
Repo and root package: shootgrow-crew. Workspace scope: @shootgrow/*. Alchemy stack name: shootgrow-crew. The & remains only in display strings (shoot&grow-crew in the UI, Better Auth appName, authenticator issuer).
Consequences
- Every import,
package.json,tsconfigand the Nx project names use the new scope (@shootgrow/web,@shootgrow/server,@shootgrow/docs). - The working directory was renamed from
shoot&grow/toshootgrow-crew/to match the repository slug; nothing in the build depended on it. - Changing the Alchemy stack name means a new stack: it must be done before the first deploy, as it was.
Revisit when
Never expected. If the product is renamed, change the scope in one sweep (it is a find-and-replace across package manifests).