Repository files navigation

Oppia is an online learning tool that enables anyone to easily create and share interactive activities (called 'explorations'). These activities simulate a one-on-one conversation with a tutor, making it possible for students to learn by doing while getting feedback.

The Android app is a frontend for Oppia that provides access to Oppia's curated numeracy lessons for users who may not have regular access to internet connectivity, and in a way that can be easily shared across multiple members of the same household. The app is now available in beta and can be installed from thePlay Store.

Oppia Android is written using Kotlin and Java, and leverages Bazel, databinding, Dagger 2, and AndroidX. See also:

• Contributors' wiki
• Oppia.org community site
• File an issue

You can also sign up to ouremail newsletter for news and updates about the overall Oppia project.

Please refer to theInstalling Oppia Android page for full instructions on how to install Oppia-Android on your local machine.

The Oppia project is built by the community for the community. We welcome contributions from everyone, especially new contributors.

You can help with Oppia's development in many ways, including

• coding
• instructional design & storytelling
• UX research
• creating voiceovers
• design & art
• documentation
• donating to support our work

Mobile developers: please seethis wiki page for instructions on setting things up and committing changes.

Other developers: seethis wiki page for instructions on setting things up for development on Oppia's frontend or backend.

All other contributors: please see ourgeneral contributor guidelines.

The Oppia Android codebase is specifically designed to streamline development by utilizing design patterns that reduce the likelihood of making mistakes, and by leveraging powerful libraries and technologies to reduce the amount of code that needs to be written. See theOverview of the Oppia Android codebase wiki page for more specifics on the architecture. A brief list of libraries & technologies that the team makes significant use of:

• Dagger
• Jetpack Databinding
• Jetpack LiveData
• Kotlin +Kotlin Coroutines
• Protobuffer
• Bazel
• Espresso &Robolectric for testing
• And many more

The team puts special emphasis on writing high-quality, readable, maintainable, and well-tested code.

If you have any feature requests or bug reports, please log them on ourissue tracker.

Please report security issues directly toadmin@oppia.org.

The Oppia Android code is released under theApache v2 license.

• Discussion forum
• Announcements mailing list