# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://native.electrode.io/v0.22/cli-commands/cauldron-add/miniapps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.