ghasseneljday / react-mobile-app-button

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!

React Component for iOS App Store, Google Play, and Huawei AppGallery Download Buttons

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!

Explore the Documentation: Documentation

Installation

You can install this package using npm:

npm install react-mobile-app-button

Or, if you prefer Yarn:

yarn add react-mobile-app-button

Once installed, you'll have access to App Store, Google Play, and AppGallery download buttons for your web page, as shown below:

Usage

Here's an example of how to use our component in your React application:

import { GooglePlayButton } from "react-mobile-app-button";

export const MyComponent = () => {
  const APKUrl = "https://play.google.com/store/apps/details?id=host";

  return (
    <div>
      <GooglePlayButton
        url={APKUrl}
        theme={"light"}
        className={"custom-style"}
      />
    </div>
  );
};

You can also import multiple buttons at once and arrange them as needed:

import {
  GooglePlayButton,
  AppGalleryButton,
  ButtonsContainer,
} from "react-mobile-app-button";

export const MyComponent = () => {
  const APKUrl = "https://play.google.com/store/apps/details?id=host";
  const IOSUrl = "https://apps.apple.com/us/app/expo-go/id982107779";

  return (
    <ButtonsContainer>
      <GooglePlayButton
        url={APKUrl}
        theme={"light"}
        className={"custom-style"}
      />

      <AppGalleryButton
        url={IOSUrl}
        theme={"light"}
        className={"custom-style"}
      />
    </ButtonsContainer>
  );
};

Props

Name	Component	Type	Description
url	GooglePlayButton, AppGalleryButton, AppStoreButton	string	Store URL
theme	GooglePlayButton, AppGalleryButton, AppStoreButton	"dark" / "light"	Button Theme
className	GooglePlayButton, AppGalleryButton, AppStoreButton	string	For manual styling
title	GooglePlayButton, AppGalleryButton, AppStoreButton	string	For custom message
height	GooglePlayButton, AppGalleryButton, AppStoreButton	number	For manual styling
width	GooglePlayButton, AppGalleryButton, AppStoreButton	number	For manual styling
gap	ButtonsContainer	number	Control the space between buttons
direction	ButtonsContainer	"row" / "column"	Control flex direction

Installation and Running the Project

To install and run the project locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/GhassenEljday/react-mobile-app-button.git

2. Install the dependencies:

   npm install

3. Run the project using Storybook:

   npm run storybook

Getting Help

If you encounter any issues or have questions, please don't hesitate to reach out to us:

• Email: [email protected]
• Issue Tracker: GitHub Issues

We're here to assist you in making the most of our React component.

react-mobile-app-button's Issues

nextjs and typescript support

nextjs and typescript support

btn Icons doesnt render locally

Missing icon

Hi, I'm using the package but a problem happens when I'm trying to use the demo code provided in the document.

Simple mistake in Readme

Greetings, you wrote "gir" instead of "git" in the cloning section in Readme.

Google Play button does not display correctly on iPhone 12,13,14 Pro Max

The text on the Google Play button appears stacked on top of each other.

buttons do not work when I import them locally in nextjs

<GooglePlayButton url={APKUrl} theme="dark" /> When I import as in this example, nextjs gives an error like this, I think the reason is written in nextjs docs

./node_modules/react-mobile-app-button/lib/components/Button/button.css
Global CSS cannot be imported from within node_modules.
Read more: https://nextjs.org/docs/messages/css-npm
Location: node_modules/react-mobile-app-button/lib/components/Button/index.js

Enable Translation for different Locales

Play Store badge should read "Get it on Google Play"

The Play Store badge should read "Get it on Google Play":

https://play.google.com/intl/en_us/badges/

as of right now, it says "Get in on Google Play":