CDX Extensibility pnpm, Building Extensions Troubleshooting & D3 Documentation
CDX Extensibility Apps 1.1.9 standardizes extension development on pnpm — use pnpm run setup to install dependencies and pnpm exec nx to run Nx. This release adds Building Extensions Troubleshooting, updates Building Extensions and Forge CLI guides for that workflow, and adds a D3 documentation link on the Documentation Site home page. See What's New below for the per-guide list.
What's New
Building Extensions Troubleshooting
- New guide — Step-by-step help for setting up cdx-extensibility-apps and your FI submission repo with pnpm.
- Existing FI submission repos (pnpm) — What to do once after your submission repo on GitHub switches to pnpm (
pnpm-lock.yaml,pnpm run setup,pnpm exec nx). - pnpm run vs pnpm exec — When to use
pnpm run(scripts defined in your repo) versuspnpm exec(running the Nx CLI). You do not need a global Nx install. - Corepack permission denied — How to fix
corepack enablewhen it cannot write next to your Node install (macOS, Linux, and Windows). If you see a permission error, follow these steps before you retrypnpm run setup. - Sandbox lockfile out of sync — Why catalog generate can show lockfile errors on the mobile sandbox, and how
[sync-mobile-sandbox]updates the lockfile for you.
Building Extensions — CDX Extensibility 1.1.9 & pnpm
- Dependency versions — The overview explains
pnpm-lock.yaml, how to recover withpnpm run setup, and links to FI submission repo migration and Corepack in troubleshooting. See also Template Repository for workspace setup. - Widgets and Features — Web and mobile getting started, FAQs, SDK reference, OLB integration, and Features mobile getting started now show pnpm commands instead of npm and
npx nx. - Extension template catalogs — Web, mobile widget, and mobile feature guides show how to list templates and generate projects with
pnpm exec nxfrom your monorepo root. - FI Id — Mobile widget and feature getting started, plus widget and feature generator docs explain 4- or 5-digit FI ids, zero-padding, and keeping leading zeros when you pass
--fiIdon the command line (--fiId="03100"or--fiId=str:03100). - Mobile Playground — Quick Start and sandbox commands use pnpm, with links to Building Extensions Troubleshooting for common setup failures.
- OLB Playground (Docker) — Developing your widget serve steps use
pnpm exec nx.
Forge CLI
- Quick Start — Step 5: Scaffold Your First Widget explains that the first cdx-extensibility-apps checkout under
~/.forge/cdx-extensibility-appsinstalls dependencies with pnpm; see also Extensibility-apps checkout if install fails. - Command Reference — Widget Commands documents that
forge widget submitrunspnpm run typecheckbefore opening a PR. - Widget Development — Web vs. Mobile Widgets catalog scaffold examples use
pnpm exec nxon web and mobile. - Troubleshooting — pnpm, Nx, and Windows reinstall steps and Reinstall dependencies, plus Corepack permission denied in Building Extensions troubleshooting.
Documentation Site
- D3 documentation section — On the home page, Building on the Digital Banking platform? includes a link to D3 documentation for UI, Mobile, Backend, and Design System resources.
Get Started
- Building Extensions Troubleshooting — Start here if your FI repo now uses pnpm (Existing FI submission repos) or
corepack enablefails. - Widgets — Getting Started (Web) or Mobile — Run
pnpm run setup, then usepnpm exec nxto generate, build, and preview. - Extension Template Catalog — Run
pnpm exec nx run list-web-widget-templates(Browse the Catalog) or the mobile list command before you generate. - Forge CLI Quick Start — Create and preview widgets with the pnpm-based extensibility checkout.
- Documentation Site home — Use the Go to D3 documentation link for D3 platform docs outside this site.
The Candescent Developer Experience Team