# miniapps

## Description

* Add one or more MiniApps to a non-released native application version in a Cauldron  
* Perform multiple checks, including MiniApp dependencies analysis, to ensure compatibility with the target native application container  
* Generate and publish a new Container version  

  The native application uses the new Container version to access the new MiniApp.

## Syntax

`ern cauldron add miniapps <miniapps..>`

**Arguments**

`<miniapps..>`

* One or more package path to MiniApps (delimited by spaces) to add to a target native application version in the Cauldron.

**Example**

`ern cauldron add miniapps MyFirstMiniApp@1.0.0 MySecondMiniApp@2.0.0`

**Options**

`--containerVersion/-v <version>`

* Specify a version for the new container &#x20;
* **Default**  Incremental patch number of the current container version &#x20;

  Example: If the current container version is 1.2.3 and a version is not included in the command, the new container version will be 1.2.4. &#x20;

`--descriptor/-d <descriptor>`

* Add the MiniApp to a given target native application version in the Cauldron matching the provided native application descriptor. &#x20;
* You can only pass a complete native application descriptor as the MiniApp added through this command targets only a specific single native application version. &#x20;

  **Default**  Lists all non-released native application versions from the Cauldron and  prompts you to choose one to add to the MiniApp. &#x20;

  **Example** `ern cauldron add miniapps <miniapps..> -d MyNativeApp:android:1.0.0` &#x20;

`--force/-f`

* Bypass compatibility checks and force-add the MiniApp to the Cauldron. &#x20;

  **Caution**  Before using the `--force/-f` option, be sure that you can bypass compatibility checks.

## Remarks

* If one MiniApp does not pass compatibility checks, the MiniApp is not added to the Cauldron and a new container version is not generated.

## Related commands

\[ern cauldron update miniapps] | Updates the version of an existing MiniApp

\[ern cauldron update miniapps]: ../update/miniapps.md