Skip to content

Releases: carsteneu/mystarhistory

v1.1.0 — Orphan branch + attribution

Choose a tag to compare

@carsteneu carsteneu released this 09 Jul 20:21
cc3b979

What's new since v1.0.0

Orphan branch mode (breaking change)

The action now pushes SVGs to a dedicated star-history orphan branch instead of committing to main. This solves:

  • Branch protection: no PAT or bypass needed, GITHUB_TOKEN works
  • No main pollution: chart updates don't clutter your commit history
  • No README mutation: the action never touches your README

The orphan branch is managed in a temporary directory — your workspace is never modified.

Attribution

Every SVG now contains "Made with carsteneu/mystarhistory" (13px, solid #000/#fff) in the bottom-right corner.

Bug fixes

  • git fetch instead of ls-remote for branch detection (fixes false positives)
  • src -> srcset in <source> tag (fixes dark mode switching)
  • Git identity and safe.directory set in entrypoint for CI

Cleanup

  • 14 merged branches deleted
  • Stale root SVGs removed
  • README: outdated Automation section replaced with Manual workflow alternative
  • Git examples corrected to match actual code

Upgrade from v1.0.0

Update your workflow to carsteneu/mystarhistory@v1.1.0 (or @v1 which now points to v1.1.0). Then change your README embed to point at the star-history branch via raw URL:

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OWNER/REPO/star-history/assets/my-star-history/star-history-dark.svg">
  <img alt="Star history" src="https://raw.githubusercontent.com/OWNER/REPO/star-history/assets/my-star-history/star-history-light.svg">
</picture>

The first run after upgrading will create the star-history branch automatically.

v1.0.0

Choose a tag to compare

@carsteneu carsteneu released this 09 Jul 14:24

My Star History v1.0.0

A self-hosted, xkcd-style star-history chart generator for any GitHub repo. Works as a CLI tool or a GitHub Action.

Features

  • CLI: python3 mystarhistory.py --repo owner/name generates a static SVG
  • GitHub Action: self-updating chart in your README via Docker action
  • Light + dark theme with GitHub theme auto-switching (<picture> element)
  • xkcd sketch style with embedded Handlee font
  • Zero dependencies (Python 3 stdlib + gh CLI)
  • 87 tests, 98% coverage with golden-file snapshot tests

Usage as Action

- uses: carsteneu/mystarhistory@v1
  with:
    repos: ${{ github.repository }}

Add <!-- my-star-history:start --> and <!-- my-star-history:end --> markers to your README — the action fills the space between them automatically.

Inputs

input default description
repos current repo Comma-separated owner/repo list
themes light,dark Themes to render
token ${{ github.token }} Token for stargazers API
color #dd4528 Chart line color
commit true Git-commit the result
update-readme true Rewrite README between markers