xebia-functional / macroid

A modular functional UI language for Android
527 stars 37 forks source link
abstraction android composability dsl functional-programming gui scala-macros user-interface

Macroid — a Scala GUI DSL for Android

Build Status Codacy Badge Android Arsenal Join the chat at https://gitter.im/macroid/macroid

Macroid is a modular functional user interface creation language for Android, implemented with Scala macros.

Striving to be focused on one thing (GUI), Macroid promotes composability and high-level abstractions.

Prerequisites: Scala 2.10.x or 2.11.x, Android API 19+.

Latest version: 2.1.0

Snapshot version: 2.1.0-SNAPSHOT

License: MIT.

For more info head to http://47deg.github.io/macroid!

Installation


libraryDependencies ++= Seq(
  aar("org.macroid" %% "macroid" % "2.1.0")

If you want to use the SNAPSHOT version you need to add the Sonatype SNAPSHOT repo


resolvers +=
  "Sonatype OSS Snapshots" at "https://oss.sonatype.org/content/repositories/snapshots"

libraryDependencies ++= Seq(
  aar("org.macroid" %% "macroid" % "2.1.0-SNAPSHOT")

Contributing

All contributions are welcome (and encouraged)!

Commit messages

Macroid’s commit message structure is inspired by the Spray project. The message has the following format:

[=|+|!] [core|viewable|akka|docs|all]: <Actual message>.

Example:

! core: Receive UI actions in mapUi & co (fix #48)

mapUi, flatMapUi, ... now operate on UI actions, rather than simple thunks.
For example, the new type signature for mapUi is (A ⇒ Ui[B]) ⇒ Future[B].

Following this convention greatly simplifies writing the changelogs.

Documentation

Although this is not crucial, updating the docs under macroid-docs together with the code changes might save some time in the future, and thus is highly appreciated. It can be done in the same commit.

Commercial Support

47 Degrees offers commercial support for the Macroid library and associated technologies. To find out more, visit 47 Degrees' Open Source Support.