christiankaindl / serverless-stack-com

Source for Serverless-Stack.com

Learn to Build Full-Stack Apps with Serverless and React

---

Serverless Stack is an open source guide 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.

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

• Backend Serverless API
• Frontend React app

Contributing

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

Running Locally

Serverless Stack 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 PDF

You can generate the PDF locally on macOS by following these steps.

1. Generate a Cover.pdf with latest version and date
   1. Create an ebook folder in ~/Downloads (for example).
   2. Update the date and version in the etc/cover.html
   3. Open the cover page locally in Safari by going to file:///Users/frank/Sites/ServerlessStackCom/etc/cover.html.
   4. Hit the Export to PDF… button.
   5. Place Cover.pdf in the ~/Downloads/ebook folder.
2. Ensure ebook folder is an option when hitting the Export to PDF… button in Safari.
3. In the terminal, run osascript pdf.scpt in the etc/ directory of this repository.

We are looking for a better way to generate the PDF (and other eBook) formats. If you've got any ideas consider contributing.

Sponsors

Sponsor Serverless Stack on Patreon if you've found this guide useful or would like to be an official supporter. A big thanks to our supporters!

Maintainers

Serverless Stack is authored and maintained by Frank Wang (@fanjiewang) & Jay V (@jayair). Subscribe to our newsletter for updates on Serverless Stack.

Contributors

Thanks to these folks for their contributions to the content of Serverless Stack.

• Peter Eman Paver Abastillas: Social login chapters
• Bernardo Bugmann: Translating chapters to Portuguese