This is a largely defunct research project left online for posterity. If you're discovering this now, you should take a look at PushPin, a much more complete & robust implementation of this approach to software development.
Trellis is a Trello clone built as an Electron desktop application. We built Trellis to demo MPL, a distributed persistence library that allows developers to build collaborative applications that are realtime, offline, and network partition tolerant.
Our motivation to build Trellis was to create an application that would demonstrate the unique features of MPL. We chose to build a Trello clone as our demo application due to Trello's popularity as a web-based project management tool, its highly collaborative design, and its "dogfooding" usefulness so that we could use Trellis as we're building it.
Like most modern web applications, the original Trello relies on a stable Internet connection in order to function. With MPL, we can extend Trello's functionality to work offline, collaboratively with peers over a local network, and with synchronization so that peers coming back online can merge their changes with other peers using automatically merging data structures.
Trellis includes many of the basic features of Trello:
- Create cards
- Create lists
- Drag cards from one list to another
- Comment on cards
- Assign cards to individuals
In addition, Trellis includes:
- Offline Mode: Trellis is a desktop application and works offline with no network connection. Your changes will be saved locally and sync automatically when you re-establish an Internet connection.
- Realtime Collaboration: When online, Trellis will sync changes between peers in realtime.
- Automatically Merging Synchronization: Trellis uses MPL for data persistence, which uses automatically merging data structures for synchronization.
- Network Partitions: If you are disconnected from the Internet but share a local network with a peer, you can continue to collaborate in realtime with peers on the same network.
We designed Trellis as an experiment to test and demonstrate the functionality of MPL, a distributed persistence library built on top of Conflict-free Replicated Data Types (CRDTs). Our goal was to assess CRDTs to see whether these data structures, which can be automatically merged, also work well in practice. We expected there may be several issues with using CRDTs in practice, such as CRDTs becoming unperformant at even small scales, or that the developer experience might be too difficult for the typical app developer unfamiliar with CRDTs.
To our surprise, MPL was reasonably performant at our scale and we were able to design a developer interface that is intuitive, familiar to developers using modern frontend libraries, and does not require developers to understand or interface with CRDTs. The end-user experience was also impressively free of data corruption: as long as data updates are done with as small of a "granularity" as possible there are very few instance of data merging in unexpected ways and users always converged to the same application state. The remaining challenges at the conclusion of this project were mostly in building a robust and decentralized networking layer for CRDT synchronization.
You can download the latest version of Trellis from the releases page.
To test peer synchronization:
- Mac OSX: Make a copy of your
Trellis.appand start both clients.
- Windows: Start
You should see both peers in the Network panel of both clients. If you now open the same document in both clients, you'll be able to see the edits from one synchronize to the other in realtime.
You will need the Electron Forge CLI installed globally:
$ npm install --global electron-forge
Windows only: You also need to have the C++ compiler toolchain installed. The easiest way to do this is to install Microsoft's windows-build-tools from an elevated prompt (run as Administrator).
$ npm install --global --production windows-build-tools
Alternatively, you can install Visual Studio Build Tools, following the steps described here.
Linux only: You also need to have the required GTK development headers and libraries installed:
$ sudo apt install libgtk2.0-dev # example for Ubuntu 19.04
Running and testing the app
To start the app:
$ npm install $ npm start
To run tests:
$ npm test
To generate a packaged application:
$ npm run package
In Mac OSX, this generates a
trellis.apppackage located in the
out/trellis-darwin-x64directory. To run it:
$ open out/trellis-darwin-x64/trellis.app
In Windows, this generates a
Trellis.exeapplication, with associated resources, in the
out/trellis-win32-x64directory. To run it:
In Linux, this generates a
TrellisELF executable (dynamically linked). To run it: