Mistica for Android

Mistica is a framework that contains reusable UI components and utilities.

Installation

Include nexus repository in the build.gradle of your project (If it is unreachable from your vpn, please contact us):

allprojects {
    repositories {
        maven { url 'https://nexusng.tuenti.io/repository/maven-group/' }
        ...
    }
    ...
}

Inside the dependency block in the build.gradle of your application, add this line to add the library:

dependencies {
    ...
    implementation 'com.telefonica.mistica:mistica:$version'
    ...
}

In case you also want to include also the components catalog in your application:

dependencies {
    ...
    implementation 'com.telefonica.mistica:mistica:$version'
    implementation 'com.telefonica.mistica:mistica-catalog:$version'
    ...
}

Configuration

Mistica provides an Android theme for each brand supported by telefonica. Just set your App or any specific activity to use any of the following:

• MisticaTheme.Movistar
• MisticaTheme.Movistar.Prominent
• MisticaTheme.O2
• MisticaTheme.O2Classic
• MisticaTheme.Vivo

<manifest ...>
    <application
        ...
        android:theme="@style/MisticaTheme.Movistar" />
</manifest>

...
<activity
    ...
    android:theme="@style/MisticaTheme.Movistar.Prominent" />
...

Components

• Buttons
• Inputs
• Snackbars
• Screen Feedbacks
• Load Error Feedback
• Pop Overs
• Badges
• Scroll Content Indicator
• Tags
• Lists
• Headers
• Sections
• Filters
• Highlighted Cards
• Controls
• Media Cards
• Data Cards
• Steppers
• Tabs

Text Presets Styles

Library includes a set of available Text Appearance styles, applicable for all kind of TextViews.

Using fonts

Mistica defines 3 typographic styles to be used along with the library, these typefaces are defined as attributes and can be override using some allowed fonts. More info here

Demo app

There is a demo of currently implemented components in this repository. A full list of implemented components can be found here: Components.

The app can be downloaded here or manually built.

To compile the app manually run the App module in Android Studio.

Library size

Library aar size is around 270 KB, without including transitive dependencies (Lottie, material and kotlin).

Your app size increase may depend on which of these transitive libraries are already being used, and also, the usage of them, so proguard can shrink more or less code.

Just to put an example, in a common scenario where your app is already using material and kotlin libs, app size increase should be around 400 KB

Contributing

See CONTRIBUTING.md

Upgrading guide

See UPGRADING.md