Getting started

mIDE 0.4.0 ships as an x86_64 AppImage for Linux. This page covers the download, the first project and the steps for running or building from source.

Only Arch Linux and Omarchy are verified

Completed testing and interactive verification have been performed only on Arch Linux / Omarchy. Other distributions, macOS and Windows have not been manually verified. Cross-platform code and CI configuration exist in the repository but do not imply tested support.

Download

Download the latest AppImage fromGitHub Releases. The public package is an AppImage for Linux PCs with Intel or AMD processors. An ARM computer needs a separate build.

Release packages are built on Ubuntu 22.04 when a version tag is pushed. Each draft release contains the AppImage and a SHA256SUMS file, and is reviewed before publication.

Run the AppImage

Move the file somewhere permanentKeep the AppImage in a folder you control, for example~/Applications. It runs from wherever it sits.
Allow executionIn your file manager's properties, enable Allow executing file as a program. From a terminal, run:
```
chmod +x ./mIDE_*.AppImage
```
Start the editor
```
./mIDE_*.AppImage
```

AppImage does not guarantee compatibility with every distribution. Some systems need FUSE; see theAppImage troubleshooting guide. Older systems can also lack required system libraries.

Requirements

Linux x86_64: Intel or AMD processor. No ARM package is published. macOS and Windows builds are not verified.
Node.js for formatting only: Format Document needs node on the application's PATH. No runtime is bundled. Editing, image previews and the terminal work without it.
FUSE on some systems: Needed by AppImage itself, not by mIDE. Distribution packages vary.

Open a project

Press Ctrl O or choose Open Folder. The start page also remembers up to ten recently opened projects, newest first. Click a project to reopen it, or use its remove button to forget it without deleting any files.

Once a folder is open, click a file in the Explorer. Directories load when expanded. Use the Explorer's plus button to create items at the project root, and right-click an item or press Shift F10 for creation, rename and permanent deletion.

Creating a project is not a separate step. mIDE opens ordinary folders: any directory on disk works, including one created bynpm create astro or mkdir.

Run from source

InstallTauri's platform prerequisites, stable Rust and Node.js 22.12+ (Node 24 LTS recommended).

git clone https://github.com/Morganczech/mIDE.git
cd mIDE
npm ci
npm run tauri dev

npm ci also installs the pinned formatter resources. Rust dependencies are locked in src-tauri/Cargo.lock. If install scripts are disabled, run:

npm ci --prefix src-tauri/resources/formatter --omit=dev

On Arch Linux, install the packages listed in Tauri's Arch prerequisites, including webkit2gtk-4.1, base-devel,openssl, appmenu-gtk-module,libappindicator-gtk3, librsvg,xdotool, fontconfig and freetype2. Omarchy uses the ordinary Linux build. macOS needs Xcode Command Line Tools; Windows needs MSVC C++ Build Tools and WebView2.

Build

Build the Linux AppImage with:

npm run tauri build -- --bundles appimage

Output is written tosrc-tauri/target/release/bundle/appimage/. Build on Linux; a local Arch/Omarchy build does not establish compatibility with older distributions. For a different target OS, run npm run tauri buildon that OS — those platforms are currently unverified.

Formatter resources include a native Astro compiler dependency selected for the build host. Do not copy node_modules between platforms or CPU architectures. For a local executable without installers:

npm run tauri build -- --no-bundle

Next, read Features for the editor itself, orDevelopment for the repository layout and check commands.

Source and release notes:https://github.com/Morganczech/mIDE