Skip to main content

Avatar Forge: Crafting Your Digital Portrait

By Quest Master IT-Journey Team

Design and integrate a custom avatar for your contributor character profile

Estimated reading time: 1 minutes

🎨 Avatar Forge: Crafting Your Digital Portrait

“A blurred silhouette does not inspire fear — or trust. Let us give you a face.” — The Portrait Artist

🎯 Quest Objectives

  • Find or create an avatar image
  • Host the image at an accessible URL
  • Update your contributor data file
  • Verify the avatar renders on your profile

📖 Background

Your character sheet currently shows a GitHub-generated identicon. While functional, a custom avatar makes your profile uniquely yours.

🗺️ Quest Steps

Step 1: Choose Your Avatar

Options for sourcing an avatar:

Method Difficulty Notes
GitHub profile photo Easiest Use https://github.com/YOUR_USERNAME.png
Upload to repo Easy Add to assets/images/contributors/
External URL Easy Any publicly accessible image URL
Generate with AI Fun Use an AI art tool for a fantasy portrait
Custom art Advanced Draw your own class-themed portrait

Recommended size: 200×200px or larger, square aspect ratio.

Step 2: Update Your Data File

Edit _data/contributors/YOUR_USERNAME.yml:

profile:
  avatar: "https://github.com/YOUR_USERNAME.png"  # or your custom URL

Or if hosting in the repo:

profile:
  avatar: "/assets/images/contributors/YOUR_USERNAME.png"

Step 3: Host Locally (Optional)

If adding the image to the repo:

mkdir -p assets/images/contributors
cp /path/to/your/avatar.png assets/images/contributors/YOUR_USERNAME.png

Step 4: Verify

Build the site and check your profile page:

bundle exec jekyll serve
# Visit http://localhost:4000/contributors/YOUR_USERNAME/

Your avatar should appear in the circular frame at the top of your character card.

  • Avatar displays correctly
  • Fallback still works if image fails to load

🏆 Reward: Portrait Artist Badge 🎨

Once your avatar is live, you’ve earned the Portrait Artist badge (+50 XP).


“Now the realm shall know your face. Go forth, adventurer.”