Deployment

Deploy io.Connect applications for Browser and Desktop environments.

Browser Deployment

io.Connect Browser applications are standard web apps. Deploy the Platform (host) and Client apps to any web server or CDN.

• Build each app: npm run build
• Deploy the Platform app (must be accessible to all client apps)
• Deploy client apps — can be on the same or different origins
• Ensure the Platform knows client app URLs (configured in app definitions)

Desktop Deployment

Starting with io.Connect Desktop v10.0, use the Seed Project and CLI for packaging:

1. Configure the Project

npx @interopio/cli configure

2. Build the Installer

npm run make-installer

This produces an .msi installer or .zip bundle that can be distributed internally.

3. Customization

Place custom configurations, assets, and apps in the /modifications folder:

my-project/
├── modifications/
│   ├── config/
│   │   └── system.json.merge    # Platform config overrides
│   ├── assets/
│   │   ├── splash-screen.png    # Custom startup image
│   │   └── icon.ico             # Custom tray icon
│   └── apps/
│       └── my-app.json          # Local app definitions
└── package.json

4. CI/CD

The build process supports automation via GitHub Actions or any CI system:

jobs:
  build:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 18
      - run: npm ci
      - run: npm run make-installer
      - uses: actions/upload-artifact@v4
        with:
          name: installer
          path: "*.msi"