Skip to content

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, tsconfig and the Nx project names use the new scope (@shootgrow/web, @shootgrow/server, @shootgrow/docs).
  • The working directory was renamed from shoot&grow/ to shootgrow-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).

Internal documentation. Not for clients.