Home

Awesome

Xi Electron

A front-end for the xi-editor built with modern web technologies.

Build Status

NOTE: This is still a WIP!

Demo

canvas renderer

Goals of this Repo

The main motivation for this repo is to experiment and profile the speeds and performance of different rendering techniques for text editors in the browser, specifically with modern HTML5 APIs and the like. The final goal would be a fully cross-platform (desktop+mobile) text editing experience, but that's still a long hope at this stage.

Getting started

To build and run xi-electron you'll need to have NodeJS installed (Node version 6 or greater) as well as Git.

To get started:

> git clone https://github.com/acheronfail/xi-electron --recursive
> cd xi-electron
> yarn            # or: npm install

# Build xi-core:
> yarn core:build

# If you just want to run in dev mode then run:
> yarn start      # or: npm run start

# To build xi-electron into an application:
> yarn make       # or: npm run make

The yarn build:core script will attempt to build xi-editor, so you'll need Rust (see below for details). The built app will be output to xi-electron/out/.

Building xi-core

Keep in mind you'll need Rust (version 1.30+ is recommended at the moment). On macOS platforms you'll need Xcode 8.2 and other relevant build tools.

You can build and install xi-core via yarn build:core. You can re-run this script anytime you like. xi-editor is currently placed in this repository as a submodule, so we can have a "somewhat" stable experience.

If you run into build issues ensure the submodule is present, ie:

> git submodule update --init

Alternatively, if you'd like to clean and re-build everything again, you can run:

# Deletes all build artefacts:
> yarn core:clean
# Rebuilds the core:
> yarn core:build

If you'd like to build and use a more recent version of xi-editor then just place it under src/xi-core. For building xi-editor manually refer to its instructions.

Contributing

Please! 🙏

Credits

License

MIT

<!-- # TODO for `xi-electron` - [ ] figure out how to build small xi-core/xi-syntect-plugin libs - currently they're quite large - [ ] re-factor to be more platform portable (hopefully generate nice libs for non-electron platforms) - [ ] implement WebGLView -->