> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Deployment

## Zephyr Cloud Integration

Re.Pack supports deploying your React Native Applications with MiniApps to [Zephyr Cloud](https://zephyr-cloud.io) with `zephyr-repack-plugin` by adding one line of code in your build configuration file - whether you're using [Rspack](https://rspack.rs) or [webpack](https://webpack.js.org) - you can seamlessly integrate deployment into your workflow.

## About Zephyr Cloud

Zephyr Cloud is an orchestration platform for instant deployment of Web and Cross-platform applications. You can bring your own cloud provider, or use Zephyr Cloud's hosted service. Read more about [supported cloud providers](https://docs.zephyr-cloud.io/cloud).

When you are using `zephyr-repack-plugin` with a React Native project with MiniApps, Zephyr automatically handles deploying and resolving to the correct remote application without modifying build configuration files (you can keep the `remoteEntry` as `MobileCart@https://localhost:8080/mf-manifest.json` without additional changes on each deployment).

## Prerequisites

1. We assume you have a React Native project with MiniApps ready. If not, you can follow the [Quick start guide](/docs/getting-started/quick-start.md) from Re.Pack docs or use the bootstrap CLI provided by Zephyr Cloud by running `create-zephyr-apps` and select `React Native` as the framework.

```bash
npx create-zephyr-apps@latest
```

2. A Zephyr Cloud account: sign up at [Zephyr Cloud](https://app.zephyr-cloud.io?ref=repack) if you haven't already.

:::info Related docs

For more details related to `create-zephyr-apps` CLI, please refer to the [Zephyr Cloud's documentation for React Native, Re.Pack and Module Federation](https://docs.zephyr-cloud.io/bundlers/repack).

You can also read more about deployment, concepts and best practices about how to use Zephyr Cloud in their [documentation](https://docs.zephyr-cloud.io).

:::

## Configuration

Install plugin by running:


```sh [npm]
npm install zephyr-repack-plugin@latest
```

```sh [yarn]
yarn add zephyr-repack-plugin@latest
```

```sh [pnpm]
pnpm add zephyr-repack-plugin@latest
```

```sh [bun]
bun add zephyr-repack-plugin@latest
```

And wrapping your build configuration with the plugin:

```js
const { withZephyr } = require('zephyr-repack-plugin');

module.exports = withZephyr({
  // your build configuration
});
```

For more details about configuration, please refer to the [configuration guide](https://docs.zephyr-cloud.io/bundlers/repack#host-application-consumer) on Zephyr Cloud's documentation.

## Deploy to Zephyr Cloud

When enabled, your MiniApps are deployed to Zephyr Cloud automatically whenever you build, or when the development server is running on your project. A deploy URL will be generated in your terminal as shown below:

![Zephyr Cloud React Native Deploy URL](/img/repack-deploy-url.png)

### Expected behavior

If you click on the deploy URL, you will see this image:

![Asset not found](/img/asset-not-found.png)

This is expected behavior as MiniApps on React Native don't have a default root `index.html` file.

However, you can inspect whether anything was deployed by adding the suffix `/mf-manifest.json` at the end of the URL to see if the manifest file exists (this behaviour will be improved soon).

| URL                             | Manifest file                                    |
| ------------------------------- | ------------------------------------------------ |
| `https://<your-deploy-url>.com` | `https://<your-deploy-url>.com/mf-manifest.json` |

The deploy URL is instantly sharable, available and able to be used, or auto-resolved by Zephyr Cloud when you  have a MiniApp in your Host App. [Read more about deploying, managing federated application with Zephyr Cloud](https://docs.zephyr-cloud.io/how-to/mf-guide).

:::tip Learn more about Zephyr Cloud

- [Website](https://zephyr-cloud.io)
- [Documentation](https://docs.zephyr-cloud.io)
- [Discord](https://zephyr-cloud.io/discord)
- [Twitter](https://zephyr-cloud.io/twitter)
- [YouTube](https://zephyr-cloud.io/youtube)

:::