git404hub

what is contributist fr?

zurcacielos/contributist — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

tl;dr

A web-based pixel-art editor for painting a custom design onto your GitHub contribution graph and generating the commits to match it.

vibe map

mindmap
  root((Contributist))
    What it does
      Contribution graph art
      Pixel art editor
      Commit generator
    Tech stack
      TypeScript
      Node.js
      Vitest
    Use cases
      Decorate profile graph
      Import existing history
      3D export
    Audience
      Vibe coders
      GitHub users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Paint a custom pixel-art design onto your GitHub contribution graph for fun.

VIBE 2

Import your existing GitHub, GitLab, or Gitea history and add art on top of it.

VIBE 3

Export your contribution art as a 3D model to print or use in Blender.

VIBE 4

Share a design with someone else through a single encoded URL.

what's the stack?

TypeScriptNode.jsVitest

how it stacks up fr

zurcacielos/contributistcprecioso/tubecasterfarique/cursor-chat-explorer
Stars555
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-03-29
MaintenanceStale
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

A hosted demo exists, running locally just needs Node.js 18+ and npm install.

MIT lets you reuse, modify, and redistribute the code freely, including commercially, as long as you keep the copyright notice.

in plain english

Contributist is a web tool that lets you paint custom pixel art directly onto your GitHub contribution graph. Instead of leaving your commit history as a random pattern, you use a drawing board to design a layout, load community presets like a running cat or pixel hearts, and then generate a script that creates the commit history needed to match your design. The main editor is a 2D canvas where you draw with paint and eraser tools, working across multiple layers that can include custom raster art, memes, background images, and text, each with its own visibility, ordering, and locking settings. There is a vibe mode focused purely on creative drawing, and an advanced mode that gives finer control over things like noise, weekend patterns, vacation gaps, and how dense the commits look. You can also import your existing contribution history from GitHub, GitLab, or Gitea and start painting on top of what is already there. Beyond the 2D grid, there is a 3D trophy mode that turns your contribution art into a 3D scene you can export for use in software like Blender, or even send to a local shop to have printed. Finished artwork can be exported as a PNG in a few color palettes for sharing on social media, or exported as a shareable URL that encodes the whole design so someone else can open it and see the same art immediately. To actually apply the commits, Contributist offers two modes for sending your design to git. In local dev mode, running the app on your own machine lets it generate and push the commits straight to your repository. In cloud mode, since the hosted version cannot touch your local files, it instead gives you a Bash or PowerShell script to download and run yourself. The project is built with Node.js, includes a hosted demo, and uses Vitest for its test suite. It is licensed under MIT, a permissive license that lets you reuse and modify the code freely.

prompts (copy fr)

prompt 1
How do I run Contributist locally and push my pixel art to my own GitHub contribution graph?
prompt 2
Explain the difference between local dev mode and cloud mode for sending commits in Contributist.
prompt 3
Show me how to import my existing GitHub contributions into Contributist before painting.
prompt 4
Help me set environment variables for Contributist using the .env.local file.

Frequently asked questions

what is contributist fr?

A web-based pixel-art editor for painting a custom design onto your GitHub contribution graph and generating the commits to match it.

What language is contributist written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Vitest.

What license does contributist use?

MIT lets you reuse, modify, and redistribute the code freely, including commercially, as long as you keep the copyright notice.

How hard is contributist to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is contributist for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.