Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dabit3/gatsby-auth-starter-aws-amplify
Starter Project with Authentication with Gatsby & AWS Amplify
https://github.com/dabit3/gatsby-auth-starter-aws-amplify
amazon-cognito amplify aws aws-amplify aws-sdk gatsby react serverless
Last synced: 4 days ago
JSON representation
Starter Project with Authentication with Gatsby & AWS Amplify
- Host: GitHub
- URL: https://github.com/dabit3/gatsby-auth-starter-aws-amplify
- Owner: dabit3
- License: mit
- Created: 2018-08-24T22:49:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-07-04T12:29:50.000Z (over 3 years ago)
- Last Synced: 2024-12-16T05:38:39.297Z (9 days ago)
- Topics: amazon-cognito, amplify, aws, aws-amplify, aws-sdk, gatsby, react, serverless
- Language: JavaScript
- Size: 17.4 MB
- Stars: 324
- Watchers: 9
- Forks: 398
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Gatsby Auth starter with AWS Amplify
This auth starter implements a basic authentication flow for signing up signing in users as well as protected client side routing using [AWS Amplify](https://amplify.aws). Auth features:
- User sign up
- User sign in
- Multi-factor Authentication
- User sign-out![Gatsby Amplify](src/images/gatby-auth.gif)
# Deploy to the Amplify console
Click the button to deploy a fullstack app in your AWS account:
[![amplifybutton](https://oneclick.amplifyapp.com/button.svg)](https://console.aws.amazon.com/amplify/home#/deploy?repo=https://github.com/dabit3/gatsby-auth-starter-aws-amplify)
You can now continuously deploy changes to your frontend or backend and Amplify Console will automatically deploy those changes.
![Amplify Console](src/images/amplify-console.gif)
# Run locally
1. Create the project
```sh
gatsby new gatsby-amplify-auth https://github.com/dabit3/gatsby-auth-starter-aws-amplify
```2. Change into the new directory
```sh
cd gatsby-amplify-auth
```3. Install dependencies
```sh
yarn
# or
npm install
```4. Install & configure the AWS Amplify CLI.
```sh
npm install -g @aws-amplify/cliamplify configure
```> To see a video of how to configure the CLI, click [here](https://www.youtube.com/watch?v=fWbM5DLh25U)
5. Create a new AWS Amplify Project
```
amplify init
```> Here, walk through the following steps:
- Enter a name for the project __YOURPROJECTNAME__
- Enter a name for the environment __master__
- Choose your default editor: __Visual Studio Code__ (or your editor of choice)
- Choose the type of app that you're building __javascript__
- What javascript framework are you using __react__
- Source Directory Path: __src__
- Distribution Directory Path: __public__
- Build Command: __npm run-script build__
- Start Command: __npm run-script develop__6. Push the updated project configuration to AWS. It will deploy a CloudFormation template that has an Amazon Cognito resource that enables user authentication.
```sh
amplify push
```7. Then you can run it by:
```sh
gatsby develop
```