spoke-code

The command line for the spoke-code kit. Your subscription comes with a license key; this tool turns it into a site folder and keeps that folder up to date.

npx spoke-code create my-site     # new site from the current release
npx spoke-code create my-site --theme spoke   # the same, starting from a theme
npx spoke-code update             # merge the newest release into this site
npx spoke-code status             # which version, which seat
npx spoke-code logout             # free this machine's seat

create asks for your license key once and stores it in your user config folder. A seat is one machine; logout frees it, and the Polar customer portal shows every active seat.

Without --theme you get the blank starter. With one, that theme becomes your site's apps/web, and update keeps bringing you that theme's changes.

Updates use git: the pristine kit lives on a hidden spoke-code/upstream branch, and update merges the new version into your branch. Your changes stay; where the two collide, git leaves a conflict for you or your assistant to resolve. Started from a zip instead? npx spoke-code adopt sets that branch up for the version you have. A site made before the project was renamed (it has a .vibe-check folder) is moved to the new layout the first time you run update or adopt; commit your work first.

Nothing in the kit itself calls home. Only create, update, and adopt check the key.