Open Source Community Guide

Contribute to GitLegacy

GitLegacy is 100% open-source and built for developers. We welcome community contributions for new artwork presets, color themes, tech stack shields, and feature tools!

Quick 4-Step Contribution Workflow

How to get your code merged into GitLegacy in minutes.

01

Fork & Clone

Fork Sukhman369/gitlegacy on GitHub and clone locally.

02

Create Branch

Run git checkout -b feat/my-new-preset or feat/my-theme.

03

Add Code & Test

Make changes and test with npm run build & npx tsc --noEmit.

04

Submit PR

Push branch and open a Pull Request. We review and merge quickly!

What Would You Like to Add?

Choose an area below and copy the code template to start building.

1. Contribute New Matrix Presets & Patterns

Add 5x7 matrix pixel art patterns (e.g. Gaming, Tech Logos, Career, Symbols).

// 1. Open src/lib/font-matrix.ts
// 2. Add your new pattern to PRESET_PATTERNS array:
{
  id: 'my-custom-pattern',
  name: 'Space Rocket',
  text: '🚀',
  category: 'gaming', // 'gaming' | 'tech' | 'career' | 'signature'
  description: 'Retro 8-bit space rocket contribution artwork',
  matrix: [
    [0, 1, 1, 1, 0],
    [1, 2, 3, 2, 1],
    [1, 3, 4, 3, 1],
    [0, 1, 2, 1, 0],
    [0, 0, 1, 0, 0],
  ],
}

2. Contribute Custom Color Themes

Design new 5-level color gradient palettes (e.g. Synthwave, Solarized, Dracula).

// 1. Open src/lib/theme-config.ts
// 2. Add your new theme to COLOR_THEMES array:
{
  id: 'neon-synthwave',
  name: 'Synthwave Neon',
  description: 'Vibrant retrowave neon gradient matrix',
  isDark: true,
  levels: [
    '#16002c', // Level 0: Empty cell
    '#5c0099', // Level 1: Light activity
    '#8900f2', // Level 2: Medium activity
    '#b100e8', // Level 3: High activity
    '#f72585', // Level 4: Max intensity
  ],
}

3. Add Tech Stack Shields & Badges

Include new frameworks, languages, or tools in the Badge Studio gallery.

// 1. Open src/app/badges/page.tsx
// 2. Add your technology to TECH_BADGES array:
{
  name: 'Bun.js',
  logo: 'bun',
  color: 'FBF0DF',
  category: 'backend', // 'frontend' | 'backend' | 'languages' | 'databases' | 'devops'
}

Have a New Tool or Feature Idea?

Got ideas for 3D isometric contribution visualizers, README generators, or commit analytics? Open an issue on GitHub to discuss with the maintainers!

Open GitHub Discussion / Issue