Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: about 11 hours 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 (about 6 years ago)
Default Branch: master
Last Pushed: 2021-07-04T12:29:50.000Z (over 3 years ago)
Last Synced: 2024-10-30T00:33:00.737Z (14 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: 399
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/cli

amplify 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
```