# @adobe/aio-cli-lib-app-config

> node lib to provide a consistent interface to various config files that make up Adobe Developer App Builder applications and extensions

Latest version **4.2.0** (published 2026-03-10) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @adobe/aio-cli-lib-app-config
pnpm add @adobe/aio-cli-lib-app-config
yarn add @adobe/aio-cli-lib-app-config
bun add @adobe/aio-cli-lib-app-config
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 4.2.0 |
| Published | 2026-03-10 |
| First published | 2021-08-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 8 |
| Unpacked size | 52.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Maintainers | marbec, tripod, garthdb, lazd, adobe-admin, patrickfulton, trieloff, shazron, krisnye, dcpfsdk, natebaldwin, devongovett, aspro83, symanovi, dpfister, stefan-guggisberg, rofe, kptdobe, adobehalls, fullcolorcoder, djaeggi, dylandepass, mhaack, amol-anand, stopp-adobe, doten, duh_schmidt, asthabh23, zdahbi, tuicu, fmeschbe |

## Links

- npm: https://www.npmjs.com/package/@adobe/aio-cli-lib-app-config
- Repository: https://github.com/adobe/aio-cli-lib-app-config
- Homepage: https://github.com/adobe/aio-cli-lib-app-config#readme
- Issues: https://github.com/adobe/aio-cli-lib-app-config/issues
- npm.io page: https://npm.io/package/@adobe/aio-cli-lib-app-config

## Dependencies (8)

- [ajv](https://npm.io/package/ajv.md) ^8.12.0
- [js-yaml](https://npm.io/package/js-yaml.md) ^3.14.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^9.0.1
- [ajv-formats](https://npm.io/package/ajv-formats.md) ^2.1.1
- [lodash.clonedeep](https://npm.io/package/lodash.clonedeep.md) ^4.5.0
- [@adobe/aio-lib-env](https://npm.io/package/@adobe/aio-lib-env.md) ^3
- [@adobe/aio-lib-core-config](https://npm.io/package/@adobe/aio-lib-core-config.md) ^5
- [@adobe/aio-lib-core-logging](https://npm.io/package/@adobe/aio-lib-core-logging.md) ^3

## Recent versions

- 4.2.0 (latest) — 2026-03-10
- 4.1.0-pre.2026-01-09.sha-ecf7b0a0 (next) — 2026-01-09
- 4.1.0 — 2025-11-15
- 4.0.3 — 2025-01-21
- 4.0.2 — 2024-04-12
- 4.0.1 — 2024-02-08
- 4.0.0 — 2024-01-10
- 3.0.2-pre.2024-01-08.sha-754ff986 — 2024-01-08
- 3.0.2 — 2023-11-10
- 3.0.1 — 2023-09-13
- 3.0.0 — 2023-09-07
- 1.1.0 — 2023-08-09
- 2.0.1 — 2023-07-25
- 2.0.0 — 2023-07-25
- 1.0.1-pre.2023-07-14.sha-628de670 — 2023-07-14
- … 7 more at https://npm.io/package/@adobe/aio-cli-lib-app-config/versions

## README

<!--
Copyright 2021 Adobe. All rights reserved.
This file is licensed to you under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. You may obtain a copy
of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under
the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
OF ANY KIND, either express or implied. See the License for the specific language
governing permissions and limitations under the License.
-->

[![Version](https://img.shields.io/npm/v/@adobe/aio-cli-lib-app-config.svg)](https://npmjs.org/package/@adobe/aio-cli-lib-app-config)
[![Downloads/week](https://img.shields.io/npm/dw/@adobe/aio-cli-lib-app-config.svg)](https://npmjs.org/package/@adobe/aio-cli-lib-app-config)
[![Node.js CI](https://github.com/adobe/aio-cli-lib-app-config/actions/workflows/node.js.yml/badge.svg)](https://github.com/adobe/aio-cli-lib-app-config/actions/workflows/node.js.yml)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Codecov Coverage](https://img.shields.io/codecov/c/github/adobe/aio-cli-lib-app-config/master.svg?style=flat-square)](https://codecov.io/gh/adobe/aio-cli-lib-app-config/)


# aio-cli-lib-app-config

node lib to provide a consistent interface to various config files that make up Adobe Developer App Builder applications and extensions

### Loading the app config returns an object that describes the entire applications. 
Including:

- extensions
- credentials
- paths to components

Here is an example object:

```
 {
   aio: {...aioConfig...},
   packagejson: {...package.json...},
   all: {
      /*
      OPTIONAL: newer projects are organized by extensions. `application` is a placeholder used by older apps which to not explictly define extensions
      */
     'application': {
       app: {
         name, /* Name from package.json, stripped of @scope */
         version, /* version from package.json OR 0.1.0 */
         hasFrontend, /* does this app/extension have static assets to be deployed to CDN */
         hasBackend, /* does this app/extension include actions */
         dist  /* output directory, default is 'dist/'
       },
       ow: {
           /* Only relevant if hasBackend is true, these are the credentials used to deploy/invoke actions */
         apihost,
         apiversion,
         auth,
         namespace,
         package
       },
       s3: {
         creds || tvmUrl,
         credsCacheFile,
         folder,
       },
       web: {
         src,
         injectedConfig,
         distDev,
         distProd,
       },
       manifest: {
         full,
         package,
         packagePlaceholder,
         src,
       },
       actions: {
         src,
         dist,
         remote,
         urls
       }
     }
   },
   OPTIONAL:'dx/asset-compute/worker/1': {
      ...same as above...
   },
   OPTIONAL:'dx/excshell/1': {
      ...same as above...
   },
 }
```

---
_Source: https://npm.io/package/@adobe/aio-cli-lib-app-config · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._