> For the complete documentation index, see [llms.txt](https://native.electrode.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://native.electrode.io/v0.47/cli-commands/cauldron-add/miniapps.md).

# 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

## 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.
* Any MiniApp path (but file path) will be added to the Container in the Cauldron, as such, with the exception of a git path including a branch. In that case, the MiniApp path that will be added to the Container in the Cauldron will contain the commit SHA of the HEAD of the branch, rather than the branch itself.
* The following types of MiniApp paths are not supported by this command :
  * File path (ex `file://etc/example-miniapp`)
  * Git path missing branch/tag or commit sha (ex: `https://github.com/username/example-miniapp.git`)
  * Registry path missing version (ex: `example-miniapp`)
  * Registry path using a version range (ex: `example-miniapp@^1.0.0`)

**Example**

`ern cauldron add miniapps first-miniapp@1.0.0 second-miniapp@2.0.0`

**Options**

`--containerVersion/-v <version>`

* Specify a version for the new container
* **Default** Increment the patch digit of the current container version

`--descriptor/-d <descriptor>`

* Add the MiniApp to a given target native application version in the Cauldron matching the provided native application descriptor.
* 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`

`--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.

`--resetCache`\\

* Indicates whether to reset the React Native cache prior to bundling
* **Default** false

## 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](/v0.47/cli-commands/cauldron-update/miniapps.md) | Updates the version of an existing MiniApp


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
