# file

## Description

* Add a file to the Cauldron

## Syntax

`ern cauldron add file <localFilePath> <cauldronFilePath>`

**Arguments**

`<localFilePath>`

* Absolute path to a file to add to the Cauldron

`<cauldronFilePath>`

* Target file path in the Cauldron
* Relative to the root of the Cauldron repository
* Cannot start with `/`
* Should include target file name (can be same as source filename or different)
* Can contain nested directories
* All directories will be created in the Cauldron if necessary.

## Examples

* `ern cauldron add file /Users/username/bar.json foo/bar.json`\
  Add the file `bar.json` from local directory `/Users/username` to the `foo` directory of the Cauldron.
* `ern cauldron add file /Users/username/bar.json foo/new.json`\
  Add the file `bar.json` from local directory `/Users/username` to the `foo` directory of the Cauldron. Rename the file to `new.json` in the Cauldron.

## Related commands

[ern cauldron update file](https://native.electrode.io/v0.22/cli-commands/cauldron-update/file) | Update a file in the Cauldron\
\[ern cauldron del file] | Remove a file from the Cauldron

\[ern cauldron del file]: ../del/file.md