Skip to main content

Forge CLI Troubleshooting & TypeScript SDK 1.2.0

This release rewrites Forge CLI Troubleshooting so FI developers can self-serve common CLI failures — organized around forge doctor, extensibility-apps checkout recovery, npm/Nx on Windows, web and mobile preview, aspect development, and submission. Forge CLI guides are also aligned with current CLI behavior, with cross-links and a troubleshooting callout on Quick Start. TypeScript SDK documentation is updated for 1.2.0.

What's New​

Forge CLI Troubleshooting​

  • Symptom navigation — An index table at the top links common errors (doctor, auth, checkout, Nx, preview, aspect, submit) to the right section.
  • Diagnostics first — forge doctor flags (--verbose, --network, --timeout, --check, --strict, --json), exit codes, and focused checkout/Nx re-checks.
  • Checkout recovery — Clone timing, doctor refresh, and recovering reverted widget wiring.
  • Authentication — Session expiry, forge login --force, keyring persistence, and forge app select for token exchange.
  • Web preview — OLB playground startup, port remapping, remoteEntry.js readiness, and blank-shell fixes.
  • Mobile preview — Expo on simulator/emulator, Metro cache, Expo Go fallback, and QR/tunnel options.
  • Aspect Development — Vendor preset 404s, newline rendering, and mobile HTML preview (not Expo).
  • Submission — Pre-submit lint (ESLint, typecheck, markdownlint), --no-lint, and lockfile/CI recovery.

Forge CLI Guides​

  • Overview — forge doctor --network, widget vs aspect mobile preview, and links to sibling CLI guides.
  • Quick Start — Troubleshooting callout, first-clone install timing, and simulator/emulator as the default mobile path.
  • Command Reference — Updated forge doctor, forge widget preview, and forge widget submit flags; troubleshooting link for failed checks.
  • Widget Development — Current preview, submit, and --local behavior (--local scaffolds cannot preview or submit).

TypeScript SDK Documentation​

  • Updated for SDK 1.2.0 — Overview and Installation guides reflect the latest release.

Get Started​

  1. Forge CLI Troubleshooting — Run forge doctor --verbose first, then follow the section that matches your error.
  2. TypeScript SDK Overview — Explore the CandescentClient, automatic OAuth, and typed models for 1.2.0.

The Candescent Developer Experience Team