> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira-app.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Build for Production

> Package MIRA as a signed, distributable desktop app for macOS, Windows, and Linux.

## Build commands

| Command                 | Output                                                    |
| ----------------------- | --------------------------------------------------------- |
| `npm run package:mac`   | `.dmg` + `.zip` for macOS (Apple Silicon / arm64 only)    |
| `npm run package:win`   | NSIS `.exe` installer + portable `.exe` for Windows (x64) |
| `npm run package:linux` | `.AppImage` + `.deb` + `.rpm` for Linux (x64)             |
| `npm run package:all`   | All three platforms (requires macOS host for mac signing) |

Each command runs in sequence:

1. `npm run clean` — removes `out/` and `dist/`
2. `npm run download-python` — downloads the platform-specific bundled Python 3.11 distribution
3. `npm run compile-engines` — **compiles** `rlm_context/`, `nae_context/`, and both bridge scripts to `.pyc` bytecode using the bundled Python interpreter (ensures magic numbers match at runtime)
4. `npm run build` — bundles TypeScript via electron-vite (main, renderer, preload)
5. `electron-builder` — packages and optionally signs the app

## macOS code signing

Set these environment variables before building:

```bash theme={null}
export CSC_LINK="path/to/your/certificate.p12"
export CSC_KEY_PASSWORD="your-p12-password"
export APPLE_ID="your@apple.id"
export APPLE_APP_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx"
export APPLE_TEAM_ID="XXXXXXXXXX"
```

MIRA uses **hardened runtime** with the entitlements in `resources/entitlements.mac.plist`. After signing, `electron-builder` submits to Apple for notarisation automatically.

## Windows code signing

```bash theme={null}
export CSC_LINK="path/to/your/certificate.pfx"
export CSC_KEY_PASSWORD="your-pfx-password"
```

Use an EV certificate to avoid SmartScreen warnings.

## Linux (no signing required)

No environment variables needed. The AppImage and deb packages are unsigned.

## Bundled Python

The build pipeline downloads a platform-specific Python 3.11 distribution and bundles it into the app using `scripts/download-python.js`. The bundled Python is \~50 MB and is included in the final installer.

To pre-download Python before building:

```bash theme={null}
node scripts/download-python.js
```

## Build output

Packaged apps are written to `dist/`:

```
dist/
├── MIRA-0.1.0-beta.1-arm64.dmg            # macOS Apple Silicon
├── MIRA-0.1.0-beta.1-arm64-mac.zip        # macOS Apple Silicon (zip)
├── MIRA-Setup-0.1.0-beta.1-x64.exe        # Windows NSIS installer
├── MIRA-0.1.0-beta.1-x64.exe              # Windows portable
├── MIRA-0.1.0-beta.1-x64.AppImage         # Linux AppImage
├── mira_0.1.0-beta.1_amd64.deb            # Linux deb
└── mira-0.1.0-beta.1.x86_64.rpm           # Linux rpm
```

<Note>
  Edit this page — [Open a pull
  request](https://github.com/satyendra2013/mira-app/edit/main/docs/developer-guide/build-production.mdx)
</Note>