{"id":28088938,"url":"https://github.com/ghasseneljday/react-mobile-app-button","last_synced_at":"2025-05-13T12:52:40.340Z","repository":{"id":143365315,"uuid":"615507843","full_name":"GhassenEljday/react-mobile-app-button","owner":"GhassenEljday","description":"Welcome to our versatile React component designed to seamlessly integrate download buttons for iOS App Store, Google Play Store, and Huawei AppGallery. Enhance your users' experience by providing effortless access to your mobile app on popular platforms. Elevate your app's visibility and accessibility today!","archived":false,"fork":false,"pushed_at":"2024-05-29T19:21:08.000Z","size":3144,"stargazers_count":44,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T21:51:23.989Z","etag":null,"topics":["app","app-download-cta","app-gallery","app-store","app-store-integration","button","download-button-generator","google-play","google-play-store","google-play-store-button","huawei-appgallery-button","mobile-app-distribution","mobile-app-download-buttons","multi-store-download-buttons","react","react-component-for-app-downloads","react-download-button-component","react-native","store"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/react-mobile-app-button?activeTab=readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GhassenEljday.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-17T21:30:13.000Z","updated_at":"2025-04-21T09:18:28.000Z","dependencies_parsed_at":"2024-03-20T19:56:02.018Z","dependency_job_id":"01bb4a01-5753-428d-bb7d-2b41b830841f","html_url":"https://github.com/GhassenEljday/react-mobile-app-button","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GhassenEljday%2Freact-mobile-app-button","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GhassenEljday%2Freact-mobile-app-button/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GhassenEljday%2Freact-mobile-app-button/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GhassenEljday%2Freact-mobile-app-button/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GhassenEljday","download_url":"https://codeload.github.com/GhassenEljday/react-mobile-app-button/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253947818,"owners_count":21988945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["app","app-download-cta","app-gallery","app-store","app-store-integration","button","download-button-generator","google-play","google-play-store","google-play-store-button","huawei-appgallery-button","mobile-app-distribution","mobile-app-download-buttons","multi-store-download-buttons","react","react-component-for-app-downloads","react-download-button-component","react-native","store"],"created_at":"2025-05-13T12:52:39.695Z","updated_at":"2025-05-13T12:52:40.329Z","avatar_url":"https://github.com/GhassenEljday.png","language":"TypeScript","funding_links":["https://ko-fi.com/J3J5CGNZQ"],"categories":[],"sub_categories":[],"readme":"# React Component for iOS App Store, Google Play, and Huawei AppGallery Download Buttons\n\nWelcome to our versatile React component designed to seamlessly integrate download buttons for iOS App Store, Google Play Store, and Huawei AppGallery. Enhance your users' experience by providing effortless access to your mobile app on popular platforms. Elevate your app's visibility and accessibility today!\n\n**Explore the Documentation**: [Documentation](https://react-mobile-app-button-one.vercel.app/?path=/docs/example-google-play-button--docs)\n\n[![Support Us on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J5CGNZQ)\n\n## Installation\n\nYou can install this package using npm:\n\n```bash\nnpm install react-mobile-app-button\n```\n\nOr, if you prefer Yarn:\n\n```bash\nyarn add react-mobile-app-button\n```\n\nOnce installed, you'll have access to App Store, Google Play, and AppGallery download buttons for your web page, as shown below:\n\n![iOS App Store Button](https://user-images.githubusercontent.com/58111243/226064773-ee6d7ce3-e3cf-4a37-95d6-5e6db6c916c3.png)\n![Google Play Store Button](https://user-images.githubusercontent.com/58111243/226064822-65a6cf71-32fe-4298-b4ca-6f624f82dddf.png)\n\n## Usage\n\nHere's an example of how to use our component in your React application:\n\n```javascript\nimport { GooglePlayButton } from \"react-mobile-app-button\";\n\nexport const MyComponent = () =\u003e {\n  const APKUrl = \"https://play.google.com/store/apps/details?id=host\";\n\n  return (\n    \u003cdiv\u003e\n      \u003cGooglePlayButton\n        url={APKUrl}\n        theme={\"light\"}\n        className={\"custom-style\"}\n      /\u003e\n    \u003c/div\u003e\n  );\n};\n```\n\nYou can also import multiple buttons at once and arrange them as needed:\n\n```javascript\nimport {\n  GooglePlayButton,\n  AppGalleryButton,\n  ButtonsContainer,\n} from \"react-mobile-app-button\";\n\nexport const MyComponent = () =\u003e {\n  const APKUrl = \"https://play.google.com/store/apps/details?id=host\";\n  const IOSUrl = \"https://apps.apple.com/us/app/expo-go/id982107779\";\n\n  return (\n    \u003cButtonsContainer\u003e\n      \u003cGooglePlayButton\n        url={APKUrl}\n        theme={\"light\"}\n        className={\"custom-style\"}\n      /\u003e\n\n      \u003cAppGalleryButton\n        url={IOSUrl}\n        theme={\"light\"}\n        className={\"custom-style\"}\n      /\u003e\n    \u003c/ButtonsContainer\u003e\n  );\n};\n```\n\n## Props\n\n| Name      | Component                                                | Type             | Description                       |\n| --------- | -------------------------------------------------------- | ---------------- | --------------------------------- |\n| url       | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | string           | Store URL                         |\n| theme     | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | \"dark\" / \"light\" | Button Theme                      |\n| className | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | string           | For manual styling                |\n| title     | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | string           | For custom message                |\n| height    | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | number           | For manual styling                |\n| width     | `GooglePlayButton`, `AppGalleryButton`, `AppStoreButton` | number           | For manual styling                |\n| gap       | `ButtonsContainer`                                       | number           | Control the space between buttons |\n| direction | `ButtonsContainer`                                       | \"row\" / \"column\" | Control flex direction            |\n\n## Installation and Running the Project\n\nTo install and run the project locally, follow these steps:\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/GhassenEljday/react-mobile-app-button.git\n   ```\n\n2. Install the dependencies:\n\n   ```bash\n   npm install\n   ```\n\n3. Run the project using Storybook:\n\n   ```bash\n   npm run storybook\n   ```\n\n## Getting Help\n\nIf you encounter any issues or have questions, please don't hesitate to reach out to us:\n\n- **Email**: [ghasseneljday@gmail.com](mailto:ghasseneljday@gmail.com)\n- **Issue Tracker**: [GitHub Issues](https://github.com/GhassenEljday/react-mobile-app-button/issues)\n\nWe're here to assist you in making the most of our React component.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghasseneljday%2Freact-mobile-app-button","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghasseneljday%2Freact-mobile-app-button","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghasseneljday%2Freact-mobile-app-button/lists"}