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!
https://www.npmjs.com/package/react-mobile-app-button?activeTab=readme
40 stars 4 forks source link
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

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

Support Us on Ko-fi

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:

iOS App Store Button Google Play Store Button

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:

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