Skip to content
No description, website, or topics provided.
HTML JavaScript Python CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

LibertyJS Jams

A demo serverless web application created with the Serverless Framework.

To learn more visit Serverless Learn.

Setting up Our Environment

First, clone this repository.

Using SSH - git clone Or using HTTPS - git clone

Then, run cd libertyjs-jams and make sure you see two folders named backend and frontend and a file called serverless.yml.

Getting Dependencies

  • Install a stable version of Node.js and npm
  • Use npm to install the Serverless Framework globally npm install serverless -g

The Application


All the code for the backend service is contained within the backend directory as well as some sections of serverless.yml.

Inside backend there are two files.

  • The file gets all of the vote count information from the Database.
  • The file allows us to increment by one vote on any song.
  • The serverless.yml files creates a DynamoDB table for our data, ties our two files to different HTTP API endpoints and creates the appropriate permissions to scan and update the DynamoDB table.


Our frontend contains a single index.html file and a few JS and CSS files that are loaded into it. The UI relies on Semantic UI to create a simple interface. There are several basic JavaScript functions used to interact with the API endpoints, load the data into the application and to update the UI.

The endpoints will need to be set inside of the app.js later on after the backend has been deployed.

You will also need to replace auth_config.json with your own Auth0 API Keys.

Creating the Backend Service

Update the org and app values in the serverless.yml file to reflect your own Serverless Dashboard account.

Run serverless deploy in the top level directory that contains serverless.yml.

When the service finishes deploying, make sure to save the API endpoints for the next step.

Deploying the Frontend with Serverless Finch

  • Install the Serverless Finch plugin with npm install serverless-finch --save-dev
  • Configure the Serverless Finch plugin in the custom section of serverless.yml
  • Update the index.html file with the API endpoint values that were output by deploying the backend service
  • Run serverless client deploy to deploy the frontend of the application.
  • Confirm that your website bucket is correct and that you wont be overwriting anything important from it and proceed with the instructions
  • Review the output of serverless client deploy and navigate to your website!

What's next?

You can’t perform that action at this time.