Power apps code apps npm-based CLI is now generally available (Power Apps SDK v1.3.0 and CLI v1.0.0)

[Jordan Chodak (jordanchodakWork)]

Power Apps Code Apps CLI is now generally available

We’re excited to announce the general availability of the npm-based Power Apps CLI, along with updates to the Power Apps client library.

• @microsoft/power-apps@1.3.0
• @microsoft/power-apps-cli@1.0.0

This release establishes pa as the primary CLI experience for Power Apps code apps. It also adds new solution discovery and app-context capabilities, improves Dataverse data-source management, and fixes an issue affecting application lifecycle management (ALM).

The npm-based CLI is now generally available

The pa CLI is now generally available and can be adopted without making code changes to your existing app.

The CLI uses a consistent noun-verb command structure organized around areas such as:

• pa app
• pa auth
• pa connection
• pa connector
• pa solution

The documentation has also been rewritten to reflect the generally available pa experience.

The pac code commands remain supported, but we recommend transitioning to the npm-based CLI for the latest code apps development experience.

Action required: migrate from the legacy power-apps command

The legacy power-apps command has been removed. If you use it in scripts or automation, update your commands to use pa.

For example:

power-apps add-data-source ...

becomes:

pa app add data-source ...

Your app code doesn’t need to change, but scripts using the previous commands, flags, or environment variables might need to be updated.

Renamed flags

Previous flag	New flag
--api-id / -a	--connector
--resource-name / -t	--table
--sql-stored-procedure / -sp	--procedure
--data-source-name / -n	--name
--connection-ref / -cr	--connection-ref

The short aliases listed above are no longer supported.

Renamed environment variables

Previous variable	New variable
PA_CLI_API_ID	PA_CLI_CONNECTOR
PA_CLI_ENV_URL	PA_CLI_ORG_URL
PA_CLI_CLOUD_INSTANCE	PA_CLI_CLOUD
PA_CLI_SQL_STORED_PROCEDURE	PA_CLI_PROCEDURE

The following environment variables have been removed:

• PA_CLI_VERB
• PA_CLI_ENABLE_TELEMETRY
• PA_CLI_DISABLE_TELEMETRY
• PA_CLI_SHOW_SETTINGS

The previous PAC CLI authentication path has also been removed. IS_PAC_CLI and PAC_CLI_TELEMETRY_OPTOUT are no longer used.

List Dataverse solutions from the CLI

The new pa solution list command lets you find Dataverse solutions and view their:

• Friendly name
• Unique name
• Solution ID
• Version

The command supports --search and --json, along with interactive paging in the terminal.

Access your app’s URL with getContext()

The Power Apps client library now includes appUrl on IAppContext, allowing your app to read its own running URL:

const context = getContext();
const appUrl = context.appUrl;

This capability is rolling out gradually by region. The property might initially be undefined until the service update reaches your region.

Bug fixes

• Environment-variable overrides are now applied to every data source. When multiple tabular data sources used the same connection reference, only the first data source retained its table-name override. Later data sources could receive a raw identifier, causing issues during ALM promotion.

  If your configuration was created before this fix, rerun pa app add data-source for the affected data sources.

• Dataverse data sources can be refreshed or removed by logical name. The CLI now resolves a Dataverse data source using either its logical name, such as contact, or its entity-set name, such as contacts.

Thanks for building with Power Apps code apps. As always, please continue sharing your feedback and reporting issues in this repository.

Learn more at aka.ms/pacodeapps.