https://github.com/woocommerce/woocommerce-android
WooCommerce Android app
https://github.com/woocommerce/woocommerce-android
android kotlin mobile-app woocommerce
Last synced: 3 months ago
JSON representation
WooCommerce Android app
- Host: GitHub
- URL: https://github.com/woocommerce/woocommerce-android
- Owner: woocommerce
- License: gpl-2.0
- Created: 2017-10-05T12:48:30.000Z (over 8 years ago)
- Default Branch: trunk
- Last Pushed: 2025-10-07T15:11:02.000Z (3 months ago)
- Last Synced: 2025-10-07T15:27:28.967Z (3 months ago)
- Topics: android, kotlin, mobile-app, woocommerce
- Language: Kotlin
- Homepage: https://www.woocommerce.com/mobile
- Size: 387 MB
- Stars: 295
- Watchers: 113
- Forks: 133
- Open Issues: 564
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE-OF-CONDUCT.md
- Codeowners: CODEOWNERS
- Support: docs/supporting-tablets.md
Awesome Lists containing this project
README
for Android
A Jetpack-powered mobile app for WooCommerce.
Setup Instructions •
Build & Test •
Documentation •
Contributing •
Automation •
Security •
Need Help? •
Resources •
License
## 🎉 Setup Instructions
1. Make sure you've installed [Android Studio](https://developer.android.com/studio).
1. Clone this repository in the folder of your preference, and then enter that folder:
```bash
$ git clone https://github.com/woocommerce/woocommerce-android.git
$ cd woocommerce-android
```
1. Copy `defaults.properties` to the secrets directory: `cp defaults.properties ~/.configure/woocommerce-android/secrets/secrets.properties`. See the [Configuration Files](docs/project-overview.md#configuration-files) section for a breakdown of the properties.
1. Generate the developer oauth2 tokens. These values get copied into the `~/.configure/woocommerce-android/secrets.properties` file in the next step. See the [OAuth2 Authentication](docs/project-overview.md#oauth2-authentication) section for details.
1. In Android Studio, open the project from the local repository. This will auto-generate `local.properties` with the SDK location.
1. Optional: Go to Tools → Device Manager and create an emulated device.
1. Run. (Creates a default virtual device if you skipped the previous step)
## Build & Test
To build, install, and test the project from the command line:
```bash
$ ./gradlew assembleVanillaDebug # assemble the debug .apk
$ ./gradlew installVanillaDebug # install the debug apk if you have an
# emulator or a device connected
$ ./gradlew :WooCommerce:testVanillaDebugUnitTest # assemble, install and run unit tests
$ ./gradlew :WooCommerce:connectedVanillaDebugAndroidTest # assemble, install and run Android tests
```
## 📚 Documentation
- Project Overview
- [OAuth2 Authentication](docs/project-overview.md#oauth2-authentication)
- [Configuration Files](docs/project-overview.md#configuration-files)
- [Using Detekt](docs/project-overview.md#using-detekt)
- [Google Configuration](docs/project-overview.md#google-configuration)
- Development Practices
- [Coding Style Practices](docs/coding-style.md)
- [Pull Request Guidelines](docs/pull-request-guidelines.md)
- [Material Theme Designs](docs/material-theme-designs.md)
- [Using Android Resources](docs/using-android-resources.md)
- [Localization](docs/localization.md)
- [Themes & Styling Practices](docs/theming-styling-best-practices.md)
- [Optimising screens for tablets](docs/supporting-tablets.md)
- Data
- [Tracking Events](docs/tracking-events.md)
- Accessibility
- [Accessibility Guidelines](docs/accessibility-guidelines.md)
- [Right to Left Layout Guidelines](docs/right-to-left-layout-guidelines.md)
- Quality & Testing
- [Beta Testing](https://woocommercehalo.wordpress.com/setup/join-android-beta/)
- Features
- [Feature Flags](docs/feature-flags.md)
## 👏 Contributing
Read our [Contributing Guide](CONTRIBUTING.md) to learn about reporting issues, contributing code, and more ways to contribute.
## 🔐 Security
If you happen to find a security vulnerability, we would appreciate you letting us know at https://hackerone.com/automattic and allowing us to respond before disclosing the issue publicly.
## 🦮 Need Help?
You can find the WooCommerce usage docs
here: [woocommerce.com/documentation/woocommerce/](https://woocommerce.com/documentation/woocommerce/)
General usage and development questions:
* [WooCommerce Slack Community](https://woocommerce.com/community-slack/)
* [WordPress.org Forums](https://wordpress.org/support/plugin/woocommerce)
* [The WooCommerce Help and Share Facebook group](https://www.facebook.com/groups/woohelp/)
## 🔗 Resources
- [Mobile blog](https://mobile.blog)
- [WooCommerce API Documentation (currently v3)](https://woocommerce.github.io/woocommerce-rest-api-docs/#introduction)
- [FluxC](https://github.com/wordpress-mobile/WordPress-FluxC-Android) Although the FluxC repository is now archived and its functionality has been merged into this project, it still contains valuable documentation on how to work with the underlying architecture and patterns.
## 📜 License
WooCommerce for Android is an Open Source project covered by the [GNU General Public License version 2](https://github.com/woocommerce/woocommerce-android/blob/trunk/LICENSE.md).
## 📚 Proprietary Libraries
In order to offer a great experience to our users, we use some proprietary libraries that are not open source. These libraries are:
- [ML Kit](https://developers.google.com/ml-kit) for barcode scanning and text recognition. You can find its Terms of Service [here](https://developers.google.com/ml-kit/terms).
Made with 💜 by WooCommerce.
We're hiring! Come work with us!