react-native-mobile-sms

react-native-mobile-sms

react-native-mobile-sms is a React Native package designed to facilitate direct SMS sending on Android devices. This package uses the native MobileSms module, allowing you to send messages without user interaction with the default messaging app—perfect for emergency alerts or automated messaging systems.

🚀 Features

• Send SMS directly: Send messages from your app without user interaction.
• Emergency alerts: Ideal for sending quick emergency notifications.
• Automated messaging: Seamlessly integrate SMS functionality into your apps.
• Android support: Currently supports Android devices only.

📦 Installation

Get started quickly by installing the package with npm or yarn:

npm install react-native-mobile-sms

or

yarn add react-native-mobile-sms

⚙️ Permissions

Ensure you have the necessary permissions in your Android AndroidManifest.xml:

<uses-permission android:name="android.permission.SEND_SMS"/>

📚 Usage

Import react-native-mobile-sms in your React Native component and call the sendDirectSms method with the recipient's mobile number and your message.

import React from 'react';
import { Button, View } from 'react-native';
import mobileSms from 'react-native-mobile-sms';

const App = () => {
  const sendEmergencySms = () => {
    const mobileNumber = '1234567890';
    const message = `I had an accident, please come to this location: https://maps.google.com/?q=12.821888+12.86541`;

    mobileSms.sendDirectSms(mobileNumber, message)
    .then((response) => {
      console.log("Check you success Messages :",response);
    })
    .catch((error) => {
      console.log("Check you Error Message :",error);
    })
  };

  return (
    <View>
      <Button title="Send Emergency SMS" onPress={sendEmergencySms} />
    </View>
  );
};

export default App;

📋 API

sendDirectSms(mobileNumber: string, message: string)

• mobileNumber (string): The recipient's mobile number.
• message (string): The text message to be sent.

🛠️ Example

import React from 'react';
import { Button, View } from 'react-native';
import mobileSms from 'react-native-mobile-sms';

const App = () => {
  const sendEmergencySms = () => {
    const mobileNumber = '1234567890';
    const message = `I had an accident, please come to this location: https://maps.google.com/?q=12.821888+12.86541`;

    mobileSms.sendDirectSms(mobileNumber, message)
    .then((response) => {
      console.log("Check you success Messages :",response);
    })
    .catch((error) => {
      console.log("Check you Error Message :",error);
    })
  };

  return (
    <View>
      <Button title="Send Emergency SMS" onPress={sendEmergencySms} />
    </View>
  );
};

export default App;

⚠️ Notes

• This package is currently only supported on Android devices.
• Ensure the mobile number is correctly formatted and the device has the necessary permissions to send SMS.

📝 Future Updates

We have some exciting features planned for future updates:

• iOS Support: We're working on extending support to iOS devices, so you can send SMS across both major platforms.
• SIM Selection: Adding functionality to select the SIM card for sending SMS, giving users more control over their messaging.

📜 License

This project is licensed under the MIT License.

🤝 Contributing

We welcome contributions! Please open an issue or submit a pull request for any changes or improvements.

🙋 Support

Encounter any issues or have questions? Open an issue on the GitHub repository.

Make your React Native app more interactive and responsive with react-native-mobile-sms. Install it today and experience seamless SMS integration.