@reliableapp/frontend-cli 1.0.1 → 1.0.3

package/README.md

@@ -14,14 +14,21 @@ That's it on a supported platform — release SHA auto-detects, project IDs come
 
 ## Installation
 
-No install needed; use via `npx`:
+Pick whichever fits your workflow:
 
+**As a devDependency (recommended for build scripts):**
 ```bash
-npx @reliableapp/frontend-cli sourcemaps upload [options]
+npm install --save-dev @reliableapp/frontend-cli
 ```
+The `reliableapp-frontend` binary then resolves automatically inside any npm script — fastest option for repeat builds.
 
-Or install globally:
+**Via `npx` (zero install):**
+```bash
+npx --yes @reliableapp/frontend-cli sourcemaps upload [options]
+```
+Slower on first run (downloads the package) but zero setup. Good for one-off CI YAML steps.
 
+**Globally:**
 ```bash
 npm i -g @reliableapp/frontend-cli
 reliableapp-frontend sourcemaps upload [options]
@@ -29,6 +36,8 @@ reliableapp-frontend sourcemaps upload [options]
 
 Requires Node 18+.
 
+> **Heads up:** if you write `reliableapp-frontend ...` directly in a shell or build script *without* installing the package locally or globally, you'll get `command not found`. The binary lives in `node_modules/.bin/` (after install) — npm scripts find it there automatically; raw shell does not.
+
 ## Setup (one-time)
 
 In the Reliable dashboard, generate an API token for your frontend project:
@@ -59,7 +68,11 @@ That's the only thing you need — the token already names the frontend project
 
 ### `package.json` script (Vercel, Netlify, Railway, Render, Coolify, Dokploy, anything Nixpacks-based)
 
-PaaS platforms that auto-build don't have CI step injection — chain the CLI into your build script instead:
+PaaS platforms that auto-build don't have CI step injection — chain the CLI into your build script. Install it as a devDependency once so the binary resolves on every build:
+
+```bash
+npm install --save-dev @reliableapp/frontend-cli
+```
 
 ```json
 {
@@ -69,6 +82,16 @@ PaaS platforms that auto-build don't have CI step injection — chain the CLI in
 }
 ```
 
+**Or skip the install and use `npx --yes`** (slower on repeat builds — downloaded each time):
+
+```json
+{
+  "scripts": {
+    "build": "vite build && npx --yes @reliableapp/frontend-cli sourcemaps upload --dist=./dist --url-prefix=https://app.example.com/"
+  }
+}
+```
+
 Set `RELIABLE_TOKEN` in the platform's environment variables UI. The CLI auto-detects the commit SHA from the platform's own env vars (no `--release` needed).
 
 ## Required SDK config

package/dist/index.js

@@ -124,12 +124,18 @@ function autodetectRelease() {
 async function sourcemapsUpload(opts) {
   const ci = detectCI();
   if (!ci && !opts.force) {
-    console.error(red("\u2717 Refusing to upload \u2014 not running in CI."));
-    console.error(gray("  No CI env var detected (CI, GITHUB_ACTIONS, VERCEL, etc)."));
-    console.error(gray("  Pass --force to override (e.g. for testing locally)."));
-    process.exit(2);
+    console.log(yellow("\u2298  Skipping sourcemap upload \u2014 not running in CI."));
+    console.log(gray("   This is normal for local builds. Add --force to override."));
+    return;
   }
   if (ci) console.log(gray(`CI detected via $${ci}`));
+  const token = (opts.token?.trim() || process.env.RELIABLE_TOKEN?.trim()) ?? "";
+  if (!token) {
+    console.error(red("\u2717 No API token provided."));
+    console.error(gray("  Pass --token=rl_fpt_... or set the RELIABLE_TOKEN environment variable."));
+    console.error(gray("  Generate a token in: Frontend Project \u2192 Settings \u2192 API Tokens."));
+    process.exit(2);
+  }
   const explicit = opts.release?.trim();
   const auto = explicit ? null : autodetectRelease();
   const release = explicit ?? auto?.release ?? "";
@@ -185,7 +191,7 @@ async function sourcemapsUpload(opts) {
       try {
         await uploadSourcemap({
           api: opts.api,
-          token: opts.token,
+          token,
           release,
           environment: opts.environment,
           assetUrl,
@@ -220,10 +226,9 @@ function computeAssetUrl(urlPrefix, relativePath) {
 var program = new Command();
 program.name("reliableapp-frontend").description("Reliable frontend CLI \u2014 sourcemaps, releases, and other build-time uploads").version("1.0.0");
 var sourcemaps = program.command("sourcemaps").description("Sourcemap operations");
-sourcemaps.command("upload").description("Upload sourcemaps for a release to the Reliable backend").requiredOption(
+sourcemaps.command("upload").description("Upload sourcemaps for a release to the Reliable backend").option(
   "--token <token>",
-  "API token (rl_fpt_...). Falls back to $RELIABLE_TOKEN. The token already names which frontend project to upload to \u2014 no other IDs needed.",
-  process.env.RELIABLE_TOKEN
+  "API token (rl_fpt_...). Falls back to $RELIABLE_TOKEN. The token already names which frontend project to upload to \u2014 no other IDs needed."
 ).option(
   "--release <id>",
   "Release identifier. Auto-detected from common platform env vars if omitted (GITHUB_SHA, VERCEL_GIT_COMMIT_SHA, RAILWAY_GIT_COMMIT_SHA, RENDER_GIT_COMMIT, etc.)."

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@reliableapp/frontend-cli",
-    "version": "1.0.1",
+    "version": "1.0.3",
     "description": "Reliable frontend CLI — upload sourcemaps and manage frontend releases from CI. Built by Ziloris · https://ziloris.com",
     "homepage": "https://reliable.ziloris.com/docs",
     "bugs": {