Git Product home page Git Product logo

mphill / react-native-cloud-storage Goto Github PK

View Code? Open in Web Editor NEW

This project forked from kuatsu/react-native-cloud-storage

0.0 0.0 0.0 3.19 MB

☁️ Save to & read from iCloud and Google Drive using React Native

Home Page: https://react-native-cloud-storage.oss.kuatsu.de/docs/intro

License: MIT License

JavaScript 3.08% Ruby 4.64% C 0.12% Objective-C 5.51% Java 8.56% TypeScript 62.03% Objective-C++ 1.32% Swift 14.75%

react-native-cloud-storage's Introduction

☁️ react-native-cloud-storage

npm bundle size GitHub GitHub last commit

This library provides a unified and streamlined API for accessing cloud storage services on iOS, Android and Web. It supports iCloud on iOS and Google Drive on all other platforms.

  • 💾 Read and write files to the cloud
  • 🧪 Fully compatible with Expo
  • 📱 iOS, Android & Web support
  • 🏎️ Lightning fast iCloud performance using native iOS APIs
  • 🌐 Google Drive REST API implementation for other platforms
  • 🧬 Easy to use React Hooks API, or use the imperative fs-style API
  • 👌 Zero dependencies, small bundle size

Installation

React Native

npm install react-native-cloud-storage
cd ios && pod install

Afterwards, follow the configuration instructions.

Expo

npx expo install react-native-cloud-storage

Afterwards, add the provided config plugin and expo prebuild or rebuild your development client.

Quick Start

import React from 'react';
import { Platform, View, Text, Button } from 'react-native';
import { CloudStorage, useCloudAvailable } from 'react-native-cloud-storage';

const App = () => {
  const cloudAvailable = useCloudAvailable();

  React.useEffect(() => {
    if (Platform.OS !== 'ios') {
      CloudStorage.setGoogleDriveAccessToken('some-access-token'); // get via @react-native-google-signin/google-signin or similar
    }
  }, []);

  const writeToCloud = async () => {
    await CloudStorage.writeFile('/file.txt', 'Hello, world!');
    console.log('Successfully wrote file to cloud');
  };

  const readFromCloud = async () => {
    const value = await CloudStorage.readFile('/file.txt');
    console.log('Successfully read file from cloud:', value);
  };

  return (
    <View>
      {cloudAvailable ? (
        <>
          <Button onPress={writeToCloud} title="Write to Cloud" />
          <Button onPress={readFromCloud} title="Read from Cloud" />
        </>
      ) : (
        <Text>The cloud storage is not available. Are you logged in?</Text>
      )}
    </View>
  );
};

Documentation

A detailed documentation is located here.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

Example Project

There's an example app available in the example directory. To use the Google Drive implementation (for any platforms other than iOS), you'll need to provide a valid access token for the Google Drive API. For testing purposes, you can create one using the Google OAuth 2.0 Playground.

License

MIT

react-native-cloud-storage's People

Contributors

mfkrause avatar kuatsucicd avatar andrashejj avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.