> For the complete documentation index, see [llms.txt](https://docs.mosaic.js.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mosaic.js.org/install-an-extension/use-a-local-extension.md).

# Install a local extension

First of all, download the extension

Create a `packages/` directory inside of your theme's root. 

{% hint style="info" %}
Conventionally, the directory to store packages is called `packages`, but you may use another name if you are willing to.
{% endhint %}

Put the extension into the `packages/<package name>` directory. Make sure that you have a `packages/<package name>/package.json` file present alongside all the other extension's contents, that means that you have unpacked the extension correctly.

```bash
.
├── 📁 packages/
│   ├── 📁 @somebody/        # All extensions of this scope will be in this dir 
│   │   └── 📁 extension1/   # This extension is a scoped package
│   │       ├── ...
│   │       └── package.json
│   └── 📁 extension2/       # This extension is not a scoped package
│       ├── ...
│       └── package.json
├── 📁 src
└── package.json
```

Add the following scripts to the `scripts` section of your theme's `package.json` file. This is necessary for your package to be automatically symlinked into the `node_modules` directory of your theme, each time after any manipulation with dependencies

{% tabs %}
{% tab title="nextjs-scripts" %}

```javascript
{
    "scripts": {
        "postinstall": "nextjs-scripts link",
        "postupdate": "nextjs-scripts link"
    }
}
```

{% endtab %}

{% tab title="cra-scripts" %}

```javascript
{
    "scripts": {
        "postinstall": "cra-scripts link",
        "postupdate": "cra-scripts link"
    }
}
```

{% endtab %}

{% tab title="node-scripts" %}

```javascript
{
    "scripts": {
        "postinstall": "node-scripts link",
        "postupdate": "node-scripts link"
    }
}
```

{% endtab %}
{% endtabs %}

Add the extension to the **dependencies** of your theme, as follows:

{% code title="./package.json" %}

```javascript
{
    "dependencies": {
        "@somebody/extension1": "file:./packages/@somebody/extension1".
        "extension2": "file:./packages/extension2".
    }
}
```

{% endcode %}

[Enable](/install-an-extension/enable-or-disable-an-extension.md) the extension:

{% code title="package.json" %}

```javascript
{
    "mosaic": {
        "extensions": {
            "@somebody/extension1": true,
            "extension2": false
        }
    }
}
```

{% endcode %}

Update the symlinks by running the following command

{% tabs %}
{% tab title="npm" %}

```bash
npm run postinstall
```

{% endtab %}

{% tab title="yarn" %}

```bash
yarn postinstall
```

{% endtab %}
{% endtabs %}