{"id":13694218,"url":"https://github.com/woocommerce/woocommerce-ios","last_synced_at":"2026-05-18T07:01:27.923Z","repository":{"id":37277629,"uuid":"118771568","full_name":"woocommerce/woocommerce-ios","owner":"woocommerce","description":"WooCommerce iOS app","archived":false,"fork":false,"pushed_at":"2026-05-15T12:02:24.000Z","size":545176,"stargazers_count":357,"open_issues_count":739,"forks_count":121,"subscribers_count":104,"default_branch":"trunk","last_synced_at":"2026-05-15T12:04:32.866Z","etag":null,"topics":["ios","mobile-app","swift","woocommerce"],"latest_commit_sha":null,"homepage":"https://www.woocommerce.com/mobile","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/woocommerce.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2018-01-24T13:49:56.000Z","updated_at":"2026-05-15T12:02:28.000Z","dependencies_parsed_at":"2026-05-15T12:02:39.779Z","dependency_job_id":null,"html_url":"https://github.com/woocommerce/woocommerce-ios","commit_stats":null,"previous_names":[],"tags_count":589,"template":false,"template_full_name":null,"purl":"pkg:github/woocommerce/woocommerce-ios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woocommerce%2Fwoocommerce-ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woocommerce%2Fwoocommerce-ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woocommerce%2Fwoocommerce-ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woocommerce%2Fwoocommerce-ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woocommerce","download_url":"https://codeload.github.com/woocommerce/woocommerce-ios/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woocommerce%2Fwoocommerce-ios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33168910,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T05:43:36.989Z","status":"ssl_error","status_checked_at":"2026-05-18T05:43:19.133Z","response_time":71,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ios","mobile-app","swift","woocommerce"],"created_at":"2024-08-02T17:01:27.020Z","updated_at":"2026-05-18T07:01:27.904Z","avatar_url":"https://github.com/woocommerce.png","language":"Swift","funding_links":[],"categories":["Shopping","iOS Apps (Search Results)"],"sub_categories":["Password"],"readme":"\n\n\u003ch1 align=\"center\"\u003e\u003cimg src=\"docs/images/logo-woo.svg\" width=\"300\"\u003e\u003cbr\u003efor iOS\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eA Jetpack-powered companion app for WooCommerce.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://buildkite.com/automattic/woocommerce-ios\"\u003e\n        \u003cimg src=\"https://badge.buildkite.com/5ad3c27f663ae4f3a3b443c1f7a5ca20e737ffe78aad15e1ec.svg?branch=trunk\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/woocommerce/woocommerce-ios/releases\"\u003e\n        \u003cimg alt=\"Release\" src=\"https://img.shields.io/github/v/tag/woocommerce/woocommerce-ios?label=release\u0026sort=semver\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/woocommerce/woocommerce-ios/blob/trunk/LICENSE\"\u003e\n        \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/woocommerce/woocommerce-ios\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#-build-instructions\"\u003eBuild Instructions\u003c/a\u003e •\n    \u003ca href=\"#-documentation\"\u003eDocumentation\u003c/a\u003e •\n    \u003ca href=\"#-contributing\"\u003eContributing\u003c/a\u003e •\n    \u003ca href=\"#-automation\"\u003eAutomation\u003c/a\u003e •\n    \u003ca href=\"#-security\"\u003eSecurity\u003c/a\u003e •\n    \u003ca href=\"#-need-help\"\u003eNeed Help?\u003c/a\u003e •\n    \u003ca href=\"#-resources\"\u003eResources\u003c/a\u003e •\n    \u003ca href=\"#-license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n## 🎉 Build Instructions\n\n1. Download Xcode\n\n    At the moment *WooCommerce for iOS* uses Swift 5.7 and requires Xcode 14 or newer. Previous versions of Xcode can be [downloaded from Apple](https://developer.apple.com/downloads/index.action).\n\n2. Install Ruby. We recommend using [rbenv](https://github.com/rbenv/rbenv) to install it. Please refer to the [`.ruby-version` file](.ruby-version) for the required Ruby version.\n\n    We use Ruby to manage the third party dependencies and other tools and automation.\n\n2. Clone project in the folder of your preference\n\n    ```bash\n    git clone https://github.com/woocommerce/woocommerce-ios.git\n    ````\n\n3. Enter the project directory\n\n    ```bash\n    cd woocommerce-ios\n    ```\n\n4. Install the third party dependencies and tools required to run the project.\n\n\n    ```bash\n    brew install xz \u0026\u0026 bundle install \u0026\u0026 bundle exec rake dependencies\n    ```\n\n    This command installs the required build tools and dependencies.\n\n5. Open the project by double clicking on `WooCommerce.xcworkspace` file, or launching Xcode and choose File \u003e Open and browse to `WooCommerce.xcworkspace`\n\n### Credentials for External Contributors\n\nIn order to login to WordPress.com using the app:\n\n1. Create a [WordPress.com account](https://wordpress.com/start/user) (if you don't already have one).\n2. Create a new developer application [here](https://developer.wordpress.com/apps/).\n3. Set **\"Website URL\"** = `http://www.wordpress.com`, **\"Redirect URLs\"** = `https://localhost`, **\"Javascript Origins\"** = `https://localhost` and **\"Type\"** = `Native` and click **Create**. On the next page, click **Update**.\n4. Copy the *Client ID* and *Client Secret* from the OAuth Information.\n5. Open `WooCommerce/Credentials/Templates/ApiCredentials-Template.swift`.\n6. Fill in the `dotcomAppId` with the Client ID.\n7. Fill in the `dotcomSecret` with the Client Secret.\n8. Build and run the app on a device or inside simulator.\n\nThe build phase copies this template into each target's derived sources directory on every build, so your edits persist across clean builds.\n\nPlease, remember to not add this information on your commits and PRs.\n\n## 📚 Documentation\n\n- Architecture\n    - [Overview](docs/architecture-overview.md)\n    - [Networking](docs/NETWORKING.md)\n    - [Storage](docs/STORAGE.md)\n    - [Yosemite](docs/YOSEMITE.md)\n    - [Hardware](docs/HARDWARE.md)    \n- Coding Guidelines\n    - [Coding Style](docs/coding-style-guide.md)\n    - [Naming Conventions](docs/naming-conventions.md)\n        - [Protocols](docs/naming-conventions.md#protocols)\n        - [String Constants in Nested Enums](docs/naming-conventions.md#string-constants-in-nested-enums)\n        - [Test Methods](docs/naming-conventions.md#test-methods)\n    - [Choosing Between Structures and Classes](docs/choosing-between-structs-and-classes.md)\n    - [Creating Core Data Model Versions](docs/creating-core-data-model-versions.md)\n    - [Localization](docs/localization.md)\n    - [Switch Statements](docs/switch-statements.md)\n- Design Patterns\n    - [Copiable](docs/copiable.md)\n        - [Generating Copiable Methods](docs/copiable.md#generating-copiable-methods)\n        - [Modifying The Copiable Code Generation](docs/copiable.md#modifying-the-copiable-code-generation)\n    - [Fakeable](docs/fakeable.md)\n        - [Generating Fake Methods](docs/fakeable.md#generating-fake-methods)\n        - [Modifying Fakes Code Generation](docs/fakeable.md#modifying-the-fakeable-code-generation)\n    - [Tracking Events](docs/tracking-events.md)\n        - [Custom Properties](docs/tracking-events.md#custom-properties)\n- Quality \u0026 Testing\n    - [UI Tests](WooCommerce/WooCommerceUITests/README.md)\n    - [Testing Card Present Payments](docs/stripe-tests.md)\n    - [Beta Testing](https://woocommercehalo.wordpress.com/setup/join-ios-beta/)\n- Features\n    - [In-app Feedback](docs/in-app-feedback.md)\n    - [Card Present Payments](docs/card-present-payments.md)\n- Other\n    - [Enable hot reload with Inject](docs/inject-hot-reload.md)\n\n## 👏 Contributing\n\nRead our [Contributing Guide](CONTRIBUTING.md) to learn about reporting issues, contributing code, and more ways to contribute.\n\n## 🤖 Automation\n\n### Peril\n\nThe woocommerce-ios project uses [Peril](https://danger.systems/js/guides/peril.html) to enforce Pull Request guidelines.\n\n### Circle CI\n\nThe woocommerce-ios project uses [Circle CI](https://circleci.com/gh/woocommerce/woocommerce-ios) for continuous integration.\n\n## 🔐 Security\n\nIf 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.\n\n## 🦮 Need Help?\n\nYou can find the WooCommerce usage docs here: [docs.woocommerce.com](https://docs.woocommerce.com/)\n\nGeneral usage and development questions:\n\n* [WooCommerce Slack Community](https://woocommerce.com/community-slack/)\n* [WordPress.org Forums](https://wordpress.org/support/plugin/woocommerce)\n* The WooCommerce Help and Share Facebook group\n\n## 🔗 Resources\n\n- [Mobile blog](https://mobile.blog)\n- [WooCommerce API Documentation (currently v3)](https://woocommerce.github.io/woocommerce-rest-api-docs/#introduction)\n\n## 📜 License\n\nWooCommerce for iOS is an Open Source project covered by the [GNU General Public License version 2](LICENSE).\n\n\n\u003cp align=\"center\"\u003e\n    \u003cbr/\u003e\u003cbr/\u003e\n    Made with 💜 by \u003ca href=\"https://woocommerce.com/\"\u003eWooCommerce\u003c/a\u003e.\u003cbr/\u003e\n    \u003ca href=\"https://woocommerce.com/careers/\"\u003eWe're hiring\u003c/a\u003e! Come work with us!\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoocommerce%2Fwoocommerce-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoocommerce%2Fwoocommerce-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoocommerce%2Fwoocommerce-ios/lists"}