Terra Mach is a mapping frontend system to build graphical interfaces for devices.
This project focuses on experiences around statistical data (graphs, diagrams), mapping, and user input. When it comes to user experience, elements a user interacts with are flexible enough to build most of common experiences.
The project is in active development. Most of the APIs are stable, though some breaking changes are still possible.
This project is highly inspired by Flutter. Terra Mach is written in a systems programming language Rust. It leverages graphics library Skia to enable high performant 2D graphics.
Terra Mach crate is located in terramach folder. To use it checkout Terra Mach to your workspace and link it locally by supplying a path.
git clone https://github.com/lykhonis/terramach.git
cd MyProjectAdd dependency in Cargo.toml.
[dependencies.terramach]
path = "../terramach/terramach"Terra Mach comes with some prebuilt examples of what can be built with it.
A dashboard sample app inspired by Dark Version design. The dashboard integrates Mapbox to access maps. The integration module is located in third-party crate.
Try example by running in command line:
cd examples/dashboard
cargo run --releaseThis may take awhile for initial build, so don't hesitate to grab some ☕.
In order to access maps, you would need to supply Mapbox access token in Settings.toml. Register and get Mapbox access token by signing up here.
cd examples/dashboard
touch Settings.tomland insert following content:
[mapbox]
access-token = "ACCESS_TOKEN_GOES_HERE"
cache-path = "/tmp/mapbox.cache.db"TerraMach GUI is a composition of widgets and/or direct painting. For example, a Decoration widget paints background color but also manages its child widget.
A simple example of a counter app. On a tap, the counter is increased and UI is updated to reflect the change.
- Define a widget and its state (state is optional)
#[derive(Default, Clone, PartialEq, PartialWidget)]
struct Counter {}
#[derive(Default)]
struct CounterState {
counter: usize,
}- Implement a counter widget
impl Widget for Counter {
// prepare state for the counter
fn mount(&self, context: &mut WidgetContext, mount: &mut MountContext) {
context.set_state(CounterState::default());
}
// build a counter widget with tap gesture and white background
fn build(&self, context: &mut WidgetContext, build: &mut BuildContext) {
let state = context.state::<CounterState>().unwrap();
build.add_child(
Gesture::new(
0,
build.event_emitter(),
TapGesture::default(),
None,
Decoration::new(
Color::WHITE,
None,
Align::new(
Alignment::center(),
Text::new_text(format!("Counter {}", state.counter).as_str()),
),
),
),
);
}
// handle a single tap
fn event(&self, context: &mut WidgetContext, event: &mut EventContext) {
if let Event::Tap(_) = event.get() {
let state = context.state_mut::<CounterState>().unwrap();
state.counter += 1;
event.mark_need_build();
}
}
}- Start the app
fn main() {
App::new((1020, 640))
.with_title("Counter")
.run(Counter::default());
}In order:
| Platform | Status |
|---|---|
| Mac OS | Supported |
| Android | Partial |
| Linux | Planned |
| Windows | Planned |
| iOS | Planned |
| Web | Considered |
This software is available publicly via GPLv3 license which can be found here. For any other request please contact me.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent