Skip to content

AndriiBugai/github-collage-generator-backend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Follower Collage Generator (Backend)

This microservice provides a simple HTTP endpoint (GET /collage, returns image/png) to generate a collage image from GitHub user’s followers avatars

🚀 Key Features

  • Dynamic Image Generation: Fetches and resizes GitHub avatars into tiles to generate a composite PNG image on-the-fly.
  • Flexible Constraints: Supports custom parameters for total image size and individual tileSize with robust server-side validation.
  • Dual-Client Integration: Implemented with both the Hub4j GitHub API and a custom Spring RestClient.

🛠 Technologies

  • Language: Java 25
  • Framework: Spring Boot 4
  • API Client: org.kohsuke:github-api
  • Image Processing: java.awt.image (AWT) / javax.imageio

This application was used as a solution for qualifying phase of UA Web Challenge VIII.

How to start up in docker

  1. Build the image
docker build -t github-collage-generator-backend .
  1. Run the container
docker run --rm -p 8080:8080 -e GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> github-collage-generator

About

Spring Boot web app that generates a PNG collage from a GitHub user’s followers avatars.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors