Back home

Download

Install DevRealm on your machine.

DevRealm is built from source and packaged into a native app for your operating system. Use the one-line installer for the fastest path, or follow the manual steps to clone, build, and install it yourself.

Recommended

Quick install

Run this in your terminal. It clones the repo, installs dependencies, builds the app, packages it for your OS, and launches it.

$curl -fsSL https://devrealm.app/install.sh | bash

Works on macOS, Linux, and Windows (via Git Bash / WSL). Requires the prerequisites below.

Prerequisites

  • gitUsed to clone the repository.
  • Node.js 18+Required to install dependencies and build.
  • npmShips with Node.js; installs packages and runs the build.

Manual install

Prefer to do it step by step? Follow along to clone, build, and package the app yourself.

  1. 1

    Clone the repository

    Grab a copy of the source from GitHub and move into the project directory.

    $git clone https://github.com/adexh/devrealm.git$cd devrealm
  2. 2

    Install dependencies

    Use a clean, reproducible install from the lockfile. Falls back to `npm install` if no lockfile is present.

    $npm ci
  3. 3

    Build the app

    Compile the renderer and main process bundles.

    $npm run build
  4. 4

    Package the native app

    Produce an unpacked native bundle for your platform with electron-builder. Replace `--arm64` with `--x64` on Intel machines.

    $npx electron-builder --mac --arm64 --dir

Packaging per platform

Step 4 differs by operating system. Pick the command that matches your machine (use --x64 for Intel/AMD CPUs and --arm64 for Apple Silicon / ARM).

macOS
$npx electron-builder --mac --arm64 --dir
Linux
$npx electron-builder --linux --x64 --dir
Windows
$npx electron-builder --win --x64 --dir

Launch it

The packaged app lands under the release/ directory:

  • macOS: open DevRealm.app (drag it into /Applications to keep it).
  • Linux: run the DevRealm executable inside the unpacked bundle.
  • Windows: launch DevRealm.exe.

The quick installer handles this automatically and opens the app for you.

Heads up

Allow the app to run

DevRealm isn't code-signed or notarized yet, so the first time you open it your operating system will warn that it's from an unidentified developer. This is expected for apps built from source. Here's how to allow it.

macOS

Gatekeeper may show “DevRealm can't be opened because Apple cannot check it for malicious software” . Use either option below.

Option A — Open from the right-click menu
  1. In Finder, locate DevRealm.app (in /Applications or the release/ folder).
  2. Control-click (or right-click) it and choose Open.
  3. In the dialog, click Open again. macOS remembers your choice for future launches.
Option B — Allow it from Settings
  1. Try to open the app once and dismiss the warning.
  2. Open System Settings → Privacy & Security.
  3. Scroll to the Security section and click Open Anyway next to the DevRealm message.
Still blocked (“app is damaged”)?

Remove the quarantine flag, then open the app again:

$xattr -dr com.apple.quarantine /Applications/DevRealm.app

Windows

SmartScreen may show “Windows protected your PC”. To run DevRealm anyway:

  1. When the blue SmartScreen dialog appears, click More info.
  2. Click the Run anyway button that appears.

If the downloaded bundle is blocked, right-click DevRealm.exe → Properties, tick Unblock at the bottom of the General tab, then click OK.

Found a problem or want to read the source? View the repository on GitHub.