Awesome Open Source
Awesome Open Source

SST

Discourse posts Twitter follow Chat on Slack


The SST Guide is a comprehensive open source tutorial for building and deploying full-stack apps using Serverless and React on AWS.

We are going to create a note taking app from scratch using React.js, AWS Lambda, API Gateway, DynamoDB, and Cognito.

Demo App

It is a single-page React app powered by a serverless CRUD API. We also cover how add user authentication and handle file uploads.

The entire guide is hosted on GitHub and we use Discourse for our comments. With the help of the community we add more detail to the guide and keep it up to date.

Project Goals

  • Provide a free comprehensive resource
  • Add more content to build on core concepts
  • Keep the content accurate and up to date
  • Help people resolve their issues

Getting Help

  • If you are running into issues with a specific chapter, post in the comments for that chapter.
  • Open a new issue if you've found a bug
  • Or if you have a suggestion create a new topic in our forums
  • If you've found a typo, edit the chapter and submit a pull request.

Source for the Demo App

We also have an alternative Serverless Framework version: backend serverless API & frontend React app.

Contributing

Thank you for your considering to contribute. Read more about how you can contribute to SST.

Running Locally

SST is built using Jekyll. Follow these steps to install Jekyll.

Viewing Locally

To install, run the following in the root of the project.

$ bundle install

And to view locally.

$ bundle exec jekyll serve

You can now view the guide locally by visiting http://localhost:4000/.

You can also turn on live reloading and incremental builds while editing.

$ bundle exec jekyll serve --incremental --livereload

Generating the eBook

We use Pandoc to create the eBook. You can generate it locally by following these steps.

$ cd ~/Sites/ServerlessStackCom/etc/ebook
$ make start

This'll start a Docker instance. Inside the Docker run:

$ make pdf
$ make epub

The above are run automatically through Github Actions in this repo:

  • When a new commit is pushed to master
  • And when a new tag is pushed, the generated eBook is uploaded to S3

Contributors

Thanks to these folks for their contributions to the content of SST.


This repo is maintained by SST.



Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Reactjs (162,277
Amazon Web Services (38,246
Tutorials (23,559
Scss (18,397
Stack (16,091
Guide (12,689
Serverless (9,826
React Router (4,121
Ebook (2,303
Create React App (2,079
Serverless Framework (1,258
React Bootstrap (651