From fbaa4a7fb688daf9b4f3b89d4d52d363f2edd4c0 Mon Sep 17 00:00:00 2001 From: Brandon Corbett Date: Wed, 3 Jun 2026 17:44:29 -0400 Subject: [PATCH 1/2] refactor: rename the entire project to seamless-cli --- LICENSE.md | 2 +- README.md | 60 ++++++++++++++++++++++++++++++++++++++------ package-lock.json | 6 ++--- package.json | 13 +++++----- src/commands/help.ts | 4 +-- 5 files changed, 64 insertions(+), 21 deletions(-) diff --git a/LICENSE.md b/LICENSE.md index fcd3dbd..30c38f9 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -1,6 +1,6 @@ # License -Create Seamless ("create-seamless) is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0-only)**. +Seamless CLI ("seamless-cli") is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0-only)**. - SPDX: `AGPL-3.0-only` diff --git a/README.md b/README.md index dbb0d1a..4cb932a 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ -# create-seamless +# Seamless CLI [![License: AGPL-3.0-only](https://img.shields.io/badge/License-AGPL3-yellow.svg)](LICENSE) -[![npm version](https://img.shields.io/npm/v/create-seamless.svg?style=flat)](https://www.npmjs.com/package/create-seamless) +[![npm version](https://img.shields.io/npm/v/seamless-cli.svg?style=flat)](https://www.npmjs.com/package/seamless-cli) -`create-seamless` is a CLI for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system. +Seamless CLI is a command-line tool for bootstrapping applications with Seamless Auth, an open source, passwordless authentication system. It guides you through creating a fully working authentication stack with a web app, API, and auth server that are already connected and ready to run. @@ -14,13 +14,13 @@ It guides you through creating a fully working authentication stack with a web a Run the CLI with `npx`: ```bash -npx create-seamless my-app +npx seamless-cli init my-app ``` Or run it in your current directory: ```bash -npx create-seamless +npx seamless-cli init ``` You’ll be guided through a short setup process where you can choose: @@ -122,7 +122,7 @@ npm run dev ## What is configured for you -create-seamless handles the parts that are usually difficult to get right: +Seamless CLI handles the parts that are usually difficult to get right: - Shared API service tokens - JWT signing configuration @@ -136,7 +136,7 @@ Everything is aligned across services so the system works immediately after setu ## Included projects -create-seamless pulls from the following repositories: +Seamless CLI pulls from the following repositories: - Seamless Auth API [https://github.com/fells-code/seamless-auth-api](https://github.com/fells-code/seamless-auth-api) @@ -169,7 +169,7 @@ Seamless Auth is built around a few principles: - Production-shaped local development - Explicit configuration over hidden behavior -create-seamless exists to make this setup fast and repeatable. +Seamless CLI exists to make this setup fast and repeatable. --- @@ -181,6 +181,50 @@ create-seamless exists to make this setup fast and repeatable. --- +## Testing local CLI changes + +From the repository root, build the CLI and link the local package: + +```bash +npm install +npm run build +npm link +``` + +Then run the linked command: + +```bash +seamless --version +seamless --help +``` + +When you are done testing, remove the global link: + +```bash +npm unlink -g seamless-cli +``` + +To smoke test the package artifact before publishing: + +```bash +npm run build +TARBALL=$(npm pack --pack-destination /tmp) +TEST_DIR=$(mktemp -d) + +cd "$TEST_DIR" +npm install "/tmp/$TARBALL" +npm exec -- seamless --version +npm exec -- seamless --help +``` + +If npm cache permissions block local testing, use a writable temporary cache: + +```bash +npm --cache /tmp/npm-cache exec -- seamless --version +``` + +--- + ## License AGPL-3.0-only © 2026 Fells Code LLC diff --git a/package-lock.json b/package-lock.json index a5642b6..02e6f98 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,11 +1,11 @@ { - "name": "create-seamless", + "name": "seamless-cli", "version": "0.1.2", "lockfileVersion": 3, "requires": true, "packages": { "": { - "name": "create-seamless", + "name": "seamless-cli", "version": "0.1.2", "license": "AGPL-3.0-only", "dependencies": { @@ -14,7 +14,7 @@ "kleur": "^4.1.5" }, "bin": { - "create-seamless": "dist/index.js" + "seamless": "dist/index.js" }, "devDependencies": { "@types/adm-zip": "^0.5.7", diff --git a/package.json b/package.json index a5ca279..89cdd22 100644 --- a/package.json +++ b/package.json @@ -1,19 +1,18 @@ { - "name": "create-seamless", + "name": "seamless-cli", "version": "0.1.2", - "description": "The starter script for Seamless Auth", - "homepage": "https://github.com/fells-code/create-seamless#readme", + "description": "The Seamless Auth command-line interface", + "homepage": "https://github.com/fells-code/seamless-cli#readme", "bugs": { - "url": "https://github.com/fells-code/create-seamless/issues" + "url": "https://github.com/fells-code/seamless-cli/issues" }, "repository": { "type": "git", - "url": "git+https://github.com/fells-code/create-seamless.git" + "url": "git+https://github.com/fells-code/seamless-cli.git" }, "license": "AGPL-3.0-only", "author": "Fells Code, LLC", "bin": { - "create-seamless": "dist/index.js", "seamless": "dist/index.js" }, "type": "module", @@ -41,4 +40,4 @@ "tsx": "^4.21.0", "typescript": "^5.9.3" } -} \ No newline at end of file +} diff --git a/src/commands/help.ts b/src/commands/help.ts index f28ab79..115f617 100644 --- a/src/commands/help.ts +++ b/src/commands/help.ts @@ -2,9 +2,9 @@ import { VERSION } from "../index.js"; export function printHelp() { console.log(` -create-seamless v${VERSION} +seamless v${VERSION} -Seamless Auth CLI — scaffold and manage full-stack authentication systems. +Seamless CLI — scaffold and manage full-stack authentication systems. ──────────────────────────────────────────── From fa6d12c9bb68f72e529a0cb49fe4ac35f9e805b9 Mon Sep 17 00:00:00 2001 From: Brandon Corbett Date: Wed, 3 Jun 2026 17:44:39 -0400 Subject: [PATCH 2/2] 0.2.0 --- package-lock.json | 4 ++-- package.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 02e6f98..04025e5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "seamless-cli", - "version": "0.1.2", + "version": "0.2.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "seamless-cli", - "version": "0.1.2", + "version": "0.2.0", "license": "AGPL-3.0-only", "dependencies": { "@clack/prompts": "^1.0.1", diff --git a/package.json b/package.json index 89cdd22..1be3036 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "seamless-cli", - "version": "0.1.2", + "version": "0.2.0", "description": "The Seamless Auth command-line interface", "homepage": "https://github.com/fells-code/seamless-cli#readme", "bugs": {