orijitghosh/kodama

Analysis updated 2026-07-26

★ 20HTMLAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Turns GitHub data into art
      Embeddable SVG image
      Updates daily automatically
    Visual elements
      Commits grow foliage
      Pull requests become fruit
      Streaks create blossoms
    Customization
      Six themes available
      Four plant species
      Light and dark modes
    Tech stack
      TypeScript monorepo
      GitHub GraphQL API
      SVG renderer
    Privacy
      Public data only
      No login required
      Short-lived cache

mindmap root((repo)) What it does Turns GitHub data into art Embeddable SVG image Updates daily automatically Visual elements Commits grow foliage Pull requests become fruit Streaks create blossoms Customization Six themes available Four plant species Light and dark modes Tech stack TypeScript monorepo GitHub GraphQL API SVG renderer Privacy Public data only No login required Short-lived cache

What do people build with it?

USE CASE 1

Embed a live bonsai tree image in your GitHub profile README that reflects your contribution activity.

USE CASE 2

Try different themes and plant species by changing URL parameters to match your profile style.

USE CASE 3

Show off your pull requests, code reviews, and streaks visually through tree elements like fruit and blossoms.

What is it built with?

TypeScriptHTMLSVGGitHub GraphQL APIVercel

How does it compare?

	orijitghosh/kodama	datcc8a-max/nhom_4_quan_an_fusion	gavrielp1/salary-2045
Stars	20	20	20
Language	HTML	HTML	HTML
Setup difficulty	easy	easy	easy
Complexity	2/5	2/5	2/5
Audience	developer	general	pm founder

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

How do you get it running?

Difficulty · easy Time to first run · 5min

No setup required, just paste an image URL with your GitHub username into your profile README.

In plain English

Kodama turns your GitHub activity history into a bonsai tree illustration that you can embed in your GitHub profile. It works as a single image link: you paste a URL with your username, and it produces an SVG drawing that updates daily based on your real public GitHub data. The tree is not decorative in a random way. Each visual element maps to a specific metric from your account. Your account age determines the trunk's thickness and shape, with the pot upgrading at milestones of one, three, six, and ten years. Commits over time grow foliage pads, and this week's commits appear as bright new shoots. Merged pull requests become persimmon fruit that ripens from green to gold, while open pull requests stay as unripe green fruit. Code reviews appear as paper lanterns, closed issues as a perched bird, and stars received show up as fireflies or butterflies depending on the theme. Your current streak produces blossom clusters, and your longest streak leaves a permanent ring of pressed petals in the soil. The tree also reflects the current season with appropriate colors. You can customize the appearance through URL parameters. There are six themes including ink, dusk, paper, sakura, yozakura, and shore. You can pick different plant species like Japanese maple, ginkgo, cherry, or wisteria. The image supports light and dark modes automatically, includes screen reader descriptions, and offers four size options from a full 830 by 420 image down to an 88 by 31 badge. The project reads only public data that GitHub already displays on your profile. There are no accounts, no login, and no user database. A short-lived cache holds rendered output keyed by username, and nothing else. Private contributions are never accessed. The codebase is a TypeScript monorepo split into four parts. The engine is a pure SVG renderer with no network calls or randomness beyond a seeded number generator, making output deterministic. The service fetches your public history through GitHub's GraphQL API and serves the image, always returning a valid SVG even when something fails. The site hosts the landing page and gallery, and a thin API layer adapts everything for Vercel hosting.

Copy-paste prompts

Prompt 1

Help me add the Kodama bonsai tree image to my GitHub profile README. My username is YOUR_USERNAME. Generate the markdown image link using the sakura theme and cherry tree species.

Prompt 2

I want to compare all six Kodama themes (ink, dusk, paper, sakura, yozakura, shore) side by side. Create an HTML file that displays my bonsai tree in each theme using image tags with my username.

Prompt 3

Write a short paragraph for my GitHub profile that explains the Kodama bonsai tree image above it, mentioning that commits grow foliage, pull requests become fruit, and streaks create blossoms.

Frequently asked questions

What is kodama?

Kodama generates a bonsai tree illustration from your GitHub activity that you can embed in your profile. Paste a URL with your username and get a live SVG image where commits, pull requests, and streaks appear as tree features.

What language is kodama written in?

Mainly HTML. The stack also includes TypeScript, HTML, SVG.

How hard is kodama to set up?

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

Who is kodama for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.