Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aws-samples/aws-amplify-graphql
Sample using AWS Amplify and AWS AppSync together for user login and authorization when making GraphQL queries and mutations. Also includes complex objects for uploading and downloading data to and from S3 with a React app.
https://github.com/aws-samples/aws-amplify-graphql
aws-appsync awsmobile cognito dynamodb graphql javascript react s3
Last synced: about 2 months ago
JSON representation
Sample using AWS Amplify and AWS AppSync together for user login and authorization when making GraphQL queries and mutations. Also includes complex objects for uploading and downloading data to and from S3 with a React app.
- Host: GitHub
- URL: https://github.com/aws-samples/aws-amplify-graphql
- Owner: aws-samples
- License: mit-0
- Created: 2018-02-19T18:09:11.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-04-03T19:22:10.000Z (over 4 years ago)
- Last Synced: 2024-08-02T07:17:52.513Z (5 months ago)
- Topics: aws-appsync, awsmobile, cognito, dynamodb, graphql, javascript, react, s3
- Language: JavaScript
- Size: 6.94 MB
- Stars: 527
- Watchers: 42
- Forks: 115
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-aws-appsync - AWS AppSync GraphQL Photo Sample
- awesome-aws-amplify - aws-amplify-graphql
README
# AWS AppSync GraphQL Photo Sample
**Please submit issues to the [appsync-sdk-js](https://github.com/awslabs/aws-mobile-appsync-sdk-js/issues) repository.**
This sample application shows how to use GraphQL to build an application that a user can login to the system, then upload and download photos which are private to them. The sample is written in React and uses AWS AppSync, Amazon Cognito, Amazon DynamoDB and Amazon S3 as well as the Amplify CLI.
## Architecture Overview
## Prerequisites
+ [AWS Account](https://aws.amazon.com/mobile/details/)
+ [NodeJS](https://nodejs.org/en/download/) with [NPM](https://docs.npmjs.com/getting-started/installing-node)
+ [AWS Ampify CLI](https://aws-amplify.github.io/)
- `npm install -g @aws-amplify/cli`
- `amplify configure`
## Getting Started
1. Clone this repo locally.
```
git clone https://github.com/aws-samples/aws-amplify-graphql.git
cd aws-amplify-graphql
```
2. Initialize the amplify project.
```
amplify init
```
3. Configure an Amazon Cognito User Pool to manage user credentials.
```
amplify add auth
```
4. Configure an Amazon S3 bucket to store files.
```
amplify add storage
```
5. Configure an AWS AppSync API to interact with my backend data sources such as Amazon DynamoDB, Amazon Elasticsearch, AWS Lambda, and self hosted HTTP services.
```
amplify add api
# When prompted for a schema.graphql provide the value "schema.graphql"
# to point to the file checked in to the root of the project directory.
```
> After running this command, you edit the schema.graphql located at `amplify/backend/api/<-projectname->/schema.graphql`. You may delete the one at the root of the project directory as it will no longer be used.
6. Deploy your project.
```
amplify push
# When asked if you would like to generate client code, you can
# say no since we are using plain JavaScript.
```
7. Install client dependencies.
```
npm install
# or
yarn
```
8. Run the react application
```
npm run start
# or
yarn start
```
The AWS Amplify CLI will create an Amazon Cognito User Pool and Identity Pool, an Amazon S3 bucket with private directories to store each user's photo and an AWS AppSync API that uses Amazon DynamoDB to store data.
The sample uses [AWS Amplify](https://github.com/aws/aws-amplify) to perform the Sign-Up and Sign-In flows with a Higher Order Component.
If the application runs successfully you should be able to enter the name of a photo, choose a file and then press **Add photo**. This will make a GraphQL call to enter the record into the database and simultaneously upload the object to S3. An immediate fetch of the record will then be at the bottom of the screen.