# create-composite

## Description

* Create a JS Composite project locally.

## Syntax

`ern create-composite`

**Options**

`--baseComposite <compositePath>`

* Git or File System path, to the custom Composite repository (refer to the \[custom Composite] documentation for more information).

`--descriptor/-d <descriptor>`

* Create a new JS Composite including all the MiniApps listed in the Cauldron for the given *complete native application descriptor* &#x20;

`--extraJsDependencies/-e <dependencies>`

* Add extra JavaScript dependencies to the JS Composite project.&#x20;

`--fromGitBranches`

* Create Composite using the latest commits made to each of the MiniApp branches (HEAD), rather than using the MiniApps SHAs that are inside the current Container version. &#x20;
* This flag is only used when creating a Composite from a Cauldron descriptor &#x20;
* This flag will be ignored if the target descriptor does not contain any MiniApps tracking git branches

  **Default** false

`--jsApiImpls`

* One or more JS API implementation(s) to add to the JS Composite project.
* The  JS API implementation(s) passed to this command can be a valid Yarn package format or a Git format or file scheme. &#x20;
* This option can only be used if the `--descriptor` option is not used.

`--miniapps/-m <miniapps>`

* One or more MiniApps to add to the JS Composite project.
* The MiniApps passed to this command can be a valid Yarn package format or a Git format or file scheme. &#x20;
* This option can only be used if the `--descriptor` option is not used.

`--outDir/--out <directory>`

* Specify the directory to output the generated JS Composite project to
* The output directory should either not exist (it will be created) or be empty
* **Default**  If this option is not provided, the Composite is generated in the default platform directory `~/.ern/containergen/miniAppsComposite`.

## Related commands

[ern create-container](https://native.electrode.io/v0.40/cli-commands/create-container) | Creates a Container locally

\[custom Composite]: ./platform-parts/composite/index.md