Understood. Hacker News requires a different approach. The audience is technical, skeptical of hype, and appreciates conciseness. The tone should be direct and informative, letting the project's technical merit speak for itself.

The convention is to post a link with a title, and then add a comment immediately with more details. Here are the two components for your post.

1. The Hacker News Title Use the Show HN: prefix. The title needs to be a factual, one-sentence summary of what the project is.

Title: Show HN: SHAde – A tool that turns Git commit hashes into deterministic art

2. The First Comment (from you, the OP) This is where you provide the essential context. No fluff. Get straight to the motivation, the technical details, and the link.

Comment:

Hi HN,

I created a command-line tool called SHAde. I was looking for a more aesthetic way to represent the history of a software project than the standard git log and was inspired by the idea of procedural generation. The goal was to create a unique, deterministic 'visual fingerprint' for every commit.

Here's how it works: It takes the SHA-256 hash of a Git commit and uses it to seed a pseudorandom number generator. This PRNG then drives the generation of geometric patterns (currently bars and spirals) and the selection of colors.

A key detail was the color generation. Instead of picking random RGB values, which often results in harsh combinations, it generates palettes in perceptually uniform color spaces (CIELAB/LCH). This helps ensure the results are more visually coherent. The entire process is stateless and deterministic, so a given commit hash will always produce the exact same image.

The tool can:

Render single commits to SVG or PNG.

Generate a browsable HTML gallery of a repository's recent history.

Create an animation showing the visual transition between two commits.

It's written in Python and is open-source on GitHub: https://github.com/LalwaniPalash/SHAde

I'd be interested to hear any feedback or answer any questions.

Proton: Talk Confidentially, Coming Soon

How to quickly transcribe meetings and courses?

The Hipster PDA (2004)

Comprehensive Guide to Text-to-Image Quality Metrics

C++'s Greatest Flaw

Volkswagen to make EVs more affordable, starting with the ID.Polo and a new SUV

Live demo of building declarative trance music in Strudel [video]

Building a Train Isochrone Map for Tokyo

Reactive algorithms: How Angular took the right path

Feminist activist sent to prison for 'Allah is lesbian' T-shirt

Second choice beyond Nano Banana

The Best Designers Know Nothing About Your Industry

Trump officials ask Supreme Court to quickly allow sweeping tariffs

Le Chat. Custom MCP Connectors. Memories

India Lowers Taxes on Renewable Energy Industry in Steps to Fight Trump Tariffs

Chicago-based Amtrak trains are running out of seats

Show HN: SHAde – A tool that turns Git Commit Hashes into deterministic Art

A practical introduction to parsing in Rust

Digital Dopamine Is Consuming America. It's Time to Fight for IRL

Electromechanical Reshaping Offers Safer Eye Surgery

Digitizing Informal Public Transport in Mexico with Open Data

Former NASA chief says United States likely to lose second lunar space race

Spec-driven development with AI: Get started with a new open-source toolkit

Exercise Is a Productivity Tool

Awesome Customer IAM List

The Reason Most Startups Fail

Automating Security Research: AI Engine Exploits Complex Blind Code Injection

Supplement Stack

Engage Time: Transform Presentations with Live Polls, Q&A and Real-Time Feedback

A Populist World Order? Origins and Predictions [pdf]