KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

lode

★ 101 Open GitHub ↗

A universal GUI for unit testing built with Electron and Vue.js

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Lode](https://lode.run)

Lode is an open source [Electron](https://electronjs.org/)-based universal test runner graphical user interface. It is written in [TypeScript](http://www.typescriptlang.org) and [Vue](https://vuejs.org/).

![Lode screenshot - macOS](https://lode.run/github-screenshot.png)

## Getting started

You can download the latest pre-packaged version [here](https://lode.run/) or choose a version from the [releases](https://github.com/lodeapp/lode/releases) page. For instructions on how to use the software, see [the documentation](https://lode.run/documentation/).

Lode currently supports the following testing frameworks:

- [PHPUnit](https://lode.run/documentation/frameworks.html#phpunit)
- [Jest](https://lode.run/documentation/frameworks.html#jest)

## Development

To run it locally, you must first clone this repository and run the following commands:

```sh
npm install
npm run dev
```

Afterwards, to build an application package for the current platform, run the following:

```sh
npm run build
```

Alternatively, you can pack and execute the application directly, which is useful to debug issues that might not occur in development mode. Note that because production state is encrypted, the existing development state will not work:

```sh
npm run simulate
```

### Vue DevTools

To inspect Vue components and Pinia stores during development, start the standalone [Vue DevTools](https://devtools.vuejs.org/guide/standalone) server in a separate terminal before launching the app:

```sh
npm run devtools # Start the Vue DevTools standalone server
npm run dev      # Then start the app in another terminal
```

The app automatically detects whether the DevTools server is running on startup. If it is, it connects; if not, it starts normally with no retries. You can check the renderer console for connection status.

### Tests

The Lode codebase has two sets of tests: [Jest](https://jestjs.io/) for the main process and [Playwright](https://playwright.dev/) for the renderer process.

```sh
npm test # Unit tests
npm run test:e2e # Playwright E2E tests
npm run test:playwright # Open the Playwright UI
```

Because the Lode application enforces [context isolation](https://www.electronjs.org/docs/tutorial/context-isolation#context-isolation), we are able to run the renderer process without the need for Node.js APIs, and since Electron's API is accessed through the preload scripts using a centralized `Lode` object, we can easily mock their behavior for testing with Playwright.

If you're just getting started with Electron development, I would strongly recommend adhering to context isolation. Not only it's essential for a secure application, it also gives you a clear boundary for testing the main and renderer processes separately, as Lode does.

## License

Code is licensed under the [MIT license](LICENSE).

Usage of the software is bound to its own [terms and conditions](https://lode.run/terms/).

lode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README