youneshenniwrites / react-native-appsync-s3

React Native app for image uploads to S3 and storing their records in Amazon DynamoDB using AWS Amplify and AppSync SDK

React Native AppSync S3

This app allows the user to do the following:

• Sign Up/In to the platform.
• Access device library using Expo.
• Upload pictures to AWS S3.
• Store the pictures records in Amazon DynamoDB.
• Display the pictures in the platform.

Prerequisites

• Expo CLI

  • npm install -g expo-cli

• AWS account

• Node JS with NPM

• AWS Amplify CLI

  • npm install -g @aws-amplify/cli
  • amplify configure (link for a step by step video).

Configuring the project

1. Clone this repo to your local machine.

git clone https://github.com/yhenni1989/react-native-appsync-s3.git

cd react-native-appsync-s3

2. Add AWS Amplify dependencies to your project.

yarn add aws-amplify aws-amplify-react-native

# or

npm install aws-amplify aws-amplify-react-native

3. Initialise the AWS Amplify project.

amplify init

Follow the same instructions as below.

4. Configure an Amazon Cognito User Pool to store users credentials.

amplify add auth

# When prompt, choose: Yes, use the default configuration.

5. Add an Amazon S3 bucket to store pictures.

amplify add storage

# Choose: Content (Images, audio, video, etc.)
# Give access to only authenticated users.
# Give users read/write acces.

6. Add the AWS AppSync API to use GraphQL and store data in DynammoDB.

amplify add api

# Choose GraphQL as the API service. 
# Choose an authorization type for the API: Amazon Cognito User Pool
# Do you have an annotated GraphQL schema? Yes
# Provide your schema file path: src/graphQL/schema.graphql

7. Deploy your project to the AWS.

amplify push

Do you want to generate code for your newly created GraphQL API: No.

The AWS Amplify CLI will create an Amazon Cognito User Pool and Identity Pool, an Amazon S3 bucket to store each users photos and an AWS AppSync GraphQL API that uses Amazon DynamoDB to store data.

Running the application

1. Install client dependencies.

yarn

# or

npm install

2. You will need your AWS IAM credentials before running the application.

• Copy your access and secret keys in the src/myKeys.js file of your project.

const keys = {
 accessKey: 'blablabla',
 secretKey: 'blablabla',
}
export default keys;

• Save changes.

3. Launch the React Native app in your simulator from the terminal under your project directory.

expo start --ios

# or

expo start --android

3. Create a new user.

• The app uses the Higher Order Component withAuthenticator (HOC) from AWS Amplify to perform the authentication flow: sign up, confirm sign up and sign in users.

4. Add and display pictures.

• If the application runs successfully you should be able to press the add button, allow access to device library, and select a picture from your device. This will upload the picture to S3 then make a GraphQL call to enter the record into DynamoDB.

• You can then press the refresh button to display the picture on the screen.

Contribute

• This project needs lots of improvement. Help me grow and improve it 💪.