Skip to content

facebook/litho

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e8887ee · May 3, 2022
May 3, 2022
Dec 29, 2021
Oct 26, 2017
May 3, 2022
Apr 25, 2022
May 3, 2022
Apr 26, 2022
Apr 25, 2022
May 3, 2022
Mar 18, 2022
Feb 4, 2022
Mar 28, 2022
Dec 29, 2021
Jan 6, 2022
Feb 4, 2022
Apr 25, 2022
Apr 26, 2022
Mar 25, 2022
Dec 29, 2021
May 3, 2022
Apr 26, 2022
Apr 26, 2022
Apr 25, 2022
Apr 21, 2022
Mar 16, 2022
Feb 28, 2022
Dec 29, 2021
Mar 25, 2022
Mar 29, 2022
Mar 29, 2022
Feb 4, 2022
Mar 29, 2022
Mar 30, 2022
Apr 28, 2022
Apr 25, 2022
Apr 25, 2022
Apr 28, 2022
Apr 25, 2022
Apr 25, 2022
Apr 25, 2022
Apr 27, 2022
Dec 29, 2021
Apr 25, 2022
Apr 26, 2022
Jun 29, 2021
Jul 30, 2020
Jun 3, 2021
Feb 12, 2022
Apr 25, 2022
Aug 30, 2019
Aug 10, 2018
Oct 10, 2018
Jul 5, 2021
Apr 18, 2017
May 3, 2022
May 3, 2022
Oct 16, 2019
Oct 16, 2019
Dec 29, 2021

Repository files navigation

Litho GithubCI Bintray Join the chat at https://gitter.im/facebook/litho License

Litho is a declarative framework for building efficient UIs on Android.

  • Declarative: Litho uses a declarative API to define UI components. You simply describe the layout for your UI based on a set of immutable inputs and the framework takes care of the rest.
  • Asynchronous layout: Litho can measure and layout your UI ahead of time without blocking the UI thread.
  • View flattening: Litho uses Yoga for layout and automatically reduces the number of ViewGroups that your UI contains.
  • Fine-grained recycling: Any component such as a text or image can be recycled and reused anywhere in the UI.

To get started, check out these links:

Installation

Litho can be integrated either in Gradle or Buck projects. Read our Getting Started guide for installation instructions.

Quick start

1. Initialize SoLoader in your Application class.

public class SampleApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    SoLoader.init(this, false);
  }
}

2. Create and display a component in your Activity

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    final ComponentContext c = new ComponentContext(this);

    final Component component = Text.create(c)
        .text("Hello World")
        .textSizeDip(50)
        .build();

    setContentView(LithoView.create(c, component));
}

Run sample

You can find more examples in our sample app.

To build and run (on an attached device/emulator) the sample app, execute

$ buck fetch sample
$ buck install -r sample

or, if you prefer Gradle,

$ ./gradlew :sample:installDebug

Contributing

Before contributing to Litho, please first read the Code of Conduct that we expect project participants to adhere to.

For pull requests, please see our CONTRIBUTING guide.

See our issues page for ideas on how to contribute or to let us know of any problems.

Please also read our Coding Style and Code of Conduct before you contribute.

Getting Help

  • Post on StackOverflow using the #litho tag.
  • Chat with us on Gitter.
  • Join our Facebook Group to stay up-to-date with announcements.
  • Please open GitHub issues only if you suspect a bug in the framework or have a feature request and not for general questions.

License

Litho is licensed under the Apache 2.0 License.