Your coding year in review #GitHubUnwrapped
Try it out live: GitHubUnwrapped.com
A platform that generates a year in review video for each GitHub user. Built with Next.JS, Remotion and AWS Lambda.
Want to make your own year in review for your users?
Run npm i
to install dependencies.
Rename .env.example
to .env
Set up your AWS account according to the Remotion Lambda Setup guide. We use multiple accounts for load-balancing:
AWS_KEY_1
instead of REMOTION_AWS_ACCESS_KEY_ID
and AWS_SECRET_1
instead of REMOTION_AWS_SECRET_ACCESS_KEY
.AWS_KEY_2
and AWS_SECRET_2
to load-balance between two accounts, or paste the same credentials as before to use the same account.src/set-env-for-key.ts
, we rotate the environment variables.Deploy the functions into your AWS account(s):
npx ts-node deploy.ts
Note that some AWS regions are disabled by default. If you get an error, enable them or limit yourself to only default ones.
For caching the videos and GitHub API responses, set up a MongoDB (We use a free MongoDB Atlas Cloud instance) to save the videos. Set the connection string as MONGO_URL
.
For fetching data from GitHub, create a personal access token in your user settings (no need to grant any scopes, the GraphQL API needs to be authenticated to get public information) and set it as GITHUB_TOKEN_1
. Adding more tokens GITHUB_TOKEN_2
etc. will rotate the personal access tokens.
Optionally, provide DISCORD_CHANNEL
and DISCORD_TOKEN
values to send monitoring logs to Discord.
You now have all environment variables.
Run the web app:
npm run dev
Edit the template in the Remotion preview:
npm run preview
To deploy, connect your repository to Vercel.
Don't forget to also set the environment variables there too.
To allow thousands of people to render their video at the same time, we applied multiple strategies for scaling:
We thank GitHub for their support in realization and promotion of this project.
The music was licensed for GitHubUnwrapped.com specifically. If you create a derivative project, you may not use it.
The code in this repository: Licensed under MIT. The Remotion framework (a dependency of this project): Companies need to obtain a paid license. Read the terms here.