🌐 react-native-network-check

🛰️ A React Native library for real-time network diagnostics.

Easily check internet connectivity, connection type, API reachability, and latency — with a stunning UI or flexible hook integration.

✨ Features

• ✅ Real-time internet connection check
• 📶 Detects connection type (WiFi, cellular, etc.)
• 🌍 Checks if backend API is reachable
• ⏱ Calculates latency
• 🧠 Customizable via React Hook
• 💅 Built-in ready-to-use screen

📦 Installation

npm install react-native-network-check
npm install @react-native-community/netinfo
npx pod-install # For iOS

🚀 Quick Usage

🧩 Use the Prebuilt Screen

import React from "react";
import { NetworkStatusScreen } from "react-native-network-check";

const App = () => {
  return <NetworkStatusScreen />;
};

export default App;

⚙️ Use the Hook (Advanced)

import React from "react";
import { View, Text, Button } from "react-native";
import { useNetworkDiagnostics } from "react-native-network-check";

const CustomStatus = () => {
  const {
    isConnected,
    connectionType,
    isBaseUrlReachable,
    latency,
    lastChecked,
    status,
    refresh,
  } = useNetworkDiagnostics();

  return (
    <View style={{ padding: 20 }}>
      <Text>Connected: {isConnected ? "Yes" : "No"}</Text>
      <Text>Connection Type: {connectionType}</Text>
      <Text>API Reachable: {isBaseUrlReachable ? "Yes" : "No"}</Text>
      <Text>Latency: {latency} ms</Text>
      <Text>Last Checked: {lastChecked}</Text>
      <Text>Status: {status}</Text>
      <Button title="Refresh" onPress={refresh} />
    </View>
  );
};

export default CustomStatus;

🔧 Peer Dependencies

Ensure your project includes these:

"react": ">=17.0.0",
"react-native": ">=0.64.0",
"@react-native-community/netinfo": ">=9.0.0"

🧠 Developer Notes

• The default base URL checked is https://www.google.com
• Future support for custom URLs and polling is planned

🤝 Contributing

Contributions are welcome!

git clone https://github.com/chauhan-saurabh/react-native-network-check.git
cd react-native-network-check
npm install
npm run build

📸 Preview

📄 License

MIT © Saurabh Chauhan