retweet-leaderboard | Serverless app that maintains a leaderboard of retweet

Create an AWS account if you do not already have one and login
Go to this app's page on the Serverless Application Repository and click "Deploy"
Fill in the required parameters and click "Deploy" and wait for the deployment to complete.
Go to the AWS Lambda Console and note down the name of the TweetProcessor function that was created by the deployment.
The retweet-leaderboard app uses the aws-serverless-twitter-event-source app as a source of Tweet data. So after deploying the retweet-leaderboard to your account, you need to install the aws-serverless-twitter-event-source app to send twitter events to the retweet-leaderboard app.
TweetProcessorFunctionName - This should be set to the name of the TweetProcessor function that you noted down when installing the retweet-leaderboard app.
BatchSize - aws-serverless-twitter-event-source default value is 15. I recommend setting this to a high value like 100 to minimize writes to the Leaderboard table.
SearchText - This controls what tweets are pulled in as part of the game. Generally, you add some uncommon combination of hashtags to search for to try to limit results to just people playing the game. The app's TweetProcessor has filtering logic to ensure only the original tweets (and not individual retweet records) are counted. It also has filtering logic to ensure a tweet has at least one retweet to be added to the leaderboard. However, rather than relying on the lambda function to filter out these records, it is more efficient (and cost effective) to do this filtering at the Twitter Search API layer. You can do this by adding -filter:nativeretweets and min_retweets:1 to your SearchText parameter. So for example, if you tell your players to tweet a post containing the hashtags #serverless and #retweetgame in order to play, you would set the SearchText parameter to #serverless #retweetgame -filter:nativeretweets min_retweets:1. Also note, if you want to change the SearchText after deploying the app, you can always do this via the AWS Lambda Console by finding the TwitterSearchPoller lambda created by the aws-serverless-twitter-event-source app and changing its SEARCH_TEXT environment variable value. If you do this, you should also delete the Leaderboard record from the Leaderboard DynamoDB table so results associated with the old search are discarded.