📦 New features

• ♐ Code snippet of the day ✨ new!
  • Display a random code snippet of code you've recently wrote so people can see what you're currently working on! (#526)
• 💕 GitHub Sponsors ✨ new!
  • Display your GitHub Sponsors introduction and goal and share what you're doing for open-source! (#548)
• 📅 Isometric commit calendar
  • Statistics are now based on your overall account lifetime (#525)
  • Added new highest commit count in a single day and some minor redesigns (#528)
• 🎩 Notable contributions
  • Display an informational message when empty (#516)

🧰 Fixes

• achievements: rename "Scripter" to "Gister" (#498)
• achievements: handle leap years for account age (#501)
• languages: skip merge commits from recent analysis (#517)
• languages: ensure lang is defined before checking categories (#529)
• isocalendar: use local max rather than all-time max for bars scaling (#532)
• other: update Linguist to 2.0.0 (#518)

💪 Contributors

• @lowlighter (maintainer)
• @Nixinova https://github.com/lowlighter/metrics/pull/518 https://github.com/lowlighter/metrics/pull/524
• @spenserblack in https://github.com/lowlighter/metrics/pull/501 https://github.com/lowlighter/metrics/pull/537

🎉 Celebrating 1 year of metrics!

I'm honestly quite surprised that this project got so much traction, but I'd like to thank you all for your support, and more particularly:

• My 5 sponsors (including one-time givers)
• All 28 contributors
• All 4 000+ stargazers
• All 300+ forkers
• And all users of this project of course 🥳 !

Metrics is now a fairly large projects and has grown a lot over last year with:

• 36 plugins which covers a wide range of usages
• 4 templates including community templates support along with markdown, PDF and JSON outputs support
• 3 ways of consuming metrics, using Metrics embed through either web server or GitHub Actions, or using Metrics insights for a quick overview
• Automated workflows for testing, building, releases and deployments

I've learnt a lot with GitHub ecosystem (its API, features, the container registry, etc.), architecture designs, open-source projects management, and other various stuff.

• @Nixinova
• @spenserblack
• @Milo123459
• @Zenoo
• @aleen42
• @cherryblossom000
• @bokub
• @ArdaGurcan
• @aw1cks
• @joe733
• @legoandmars
• @qinyihao
• @PeterDaveHello
• @crazyuploader
• @MatteoGheza
• @TheNetAdmin
• @kimlimjustin
• @funkypenguin
• @raftario
• @MeerBiene
• @L-Clem
• @yutkat
• @b3z
• @0xflotus

Thanks again for your feedbacks and support, and I hope you'll continue using Metrics in the future 😎 !

♥️ Become a sponsor

📦 New features

• 💬 Discussions plugin
  • #469 Add new metrics about your upvoted discussions and comments
• 🏆 Achievements
  • #473 Add plugin_achievements_display option to switch to a more compact display
  • #470 Add new achievements that will display how much you're participating and helping in GitHub discussions
• 🈷️ Languages
  • #477 Add plugin_languages_categories and plugin_languages_recent_categories options to configure which languages categories should be displayed (supported categories are data, markup, programming and prose)
• 📘 Repository template
  • #472 Add new metrics about user count if repository hosts a GitHub Action. This uses GitHub code search to find occurences of said action in user workflows

🧰 Fixes

• c5af923 Community templates: Fix an issue which prevented the use of community template
• #453 Discussion plugin: Sort discussions categories display
• #458 GitHub Action: Remove unused dependencies
• #465 Follow-up: Use display name instead of login
• 5c72a3c Achivements plugin: improve wording of Inspirer achievement
• a6be52f GitHub Action: Will now rebuild image if GitHub container registry is not available instead of failing
• 45d86dd Metrics insights: Fix display issues
• 4490de8 Discussions plugin: Fix display issue
• cb741f0 Lines plugin: Ignore repositories when stats could not be fetched instead of failing
• 2fbed5a Base plugin: Fix display issues with calendar (wrong order and last day always blank)
• #479, #480 , #487 Documentation: Fix typos
• #485 Dependencies: Move non-NodeJS script outside of package.json
• #467 Languages plugin: All languages colors are now loaded when using indepth option even if language wasn't previously loaded through GitHub API
• c70b649 Habits plugin: Fix an issue where events were filtered case-sensitive, causing issues with usernames with uppercase in it
• c70b649 Languages plugin: Fix an issue where events were filtered case-sensitive, causing issues with usernames with uppercase in it
• 5d43b98 Web instances: Plugins only intended for repositories templates are now hidden
• c9a1ef7 Web instances: Fix an issue where base plugin options were also displayed in repositories plugin options
• #490 Repositories plugin: Fix an issue where using this plugin could cause unattended side effects (especially with base, follow-up and languages plugins but not limited to)

💪 Contributors

• @lowlighter (maintainer)
• @Nixinova https://github.com/lowlighter/metrics/pull/458 https://github.com/lowlighter/metrics/pull/453 https://github.com/lowlighter/metrics/pull/465 https://github.com/lowlighter/metrics/pull/485 https://github.com/lowlighter/metrics/pull/477 https://github.com/lowlighter/metrics/pull/467
• @ArdaGurcan https://github.com/lowlighter/metrics/pull/479 https://github.com/lowlighter/metrics/pull/480
• @TheNetAdmin https://github.com/lowlighter/metrics/pull/487

💕 Sponsors

♥️ Become a sponsor

Thanks for your support 🎉 !

⚠️ Upgrading to 3.12 is highly advised to fix issues that retro-actively impacts all prior versions of metrics because of external changes (no action needed if you are using a rolling branch like @latest, @main or @master).

In particular, the following issues have been fixed:

• Action was always rebuilt (whether using a fork or not) introducing longer runs and possible unstabilities
• indepth feature from language plugin was entirely broken following release of github/linguist 7.16

📦 New features

• 💬 Discussions plugin ✨ new!
  • #430 Add new section about GitHub discussions stats! It can keep track on how many discussions you started and in which categories, along your comments and answers total count
• 📓 Repositories plugin ✨ new!
  • #431 Display a list of chosen featured repositories that you are proud of using this new plugin!
• 🏅 Repository contributors
  • #443 Display your repositories contributors per contribution categories!
• 🏆 Achievements
  • #435 Surpass your limits with new achievement S rank! Collect these crimson badges to prove you're the very best!
  • #434 Add new "Deployer" achievements that count your CD/CI deployments on your repositories
• 📘 Repository template
  • #433 Add deployments and environments metrics
• 🌐 Web instances
  • b4ceb43 Add missing placeholder elements
  • #438 Add flags extras.features to enable unsafe and dangerous features on web instances
• 🦑 Miscelleanous
  • 7b162bf Remove misplaced debug logs
  • #436 Migrate from github/linguist gem to NodeJS port nixinova/linguist for better stability

🧰 Fixes

• #428 Support plugin: fix crash because of outdated selector
• #429 All: normalize how licenses are displayed
• #424 Languages plugin: fix indepth feature
• #414 All: fix docker image not being pulled and being rebuilt each time
• #440 Base: display all commits instead of only last year

💪 Contributors

• @lowlighter (maintainer)
• @Nixinova https://github.com/lowlighter/metrics/pull/436 https://github.com/lowlighter/metrics/pull/441

💕 Sponsors

♥️ Become a sponsor

Thanks for your support 🎉 !

📦 New features

• ↔️ Introducing columns display size ✨ new!
  • #371 You can now use columns in config_display option for a 2-columns layout which will render as a single column on smaller devices
• 🈷️ Most used languages
  • 5120f64 Estimation now display the last day that metrics was able to fetch from GitHub events, instead of the option value to avoid confusion
  • 94539fa Add plugin_languages_aliases to support custom languages display names
  • #356 Recently used languages now reproduce a "partial repository" from events fetched and retrieved the .gitattributes of your repository to take into account linguist overrides
  • #380 Indepth now display number of commits and files processed
  • • c13582ec Improvement in indepth algorithm to handle large git diff
• 💡 Coding habits
  • afdab27 Header now display how many commits events were used to compute habits
  • #373 Add plugin_habits_trim to trim unused hours on daily chart
• 🎭 Comment reactions
  • 7f08abb Add plugin_reactions_limit_issues to support custom number of issues and pull requests to fetch for reactions
    • plugin_reactions_limit now targets only comments from issues and pull requests
• 🦑 Miscelleanous
  • aa4225f config_timezone now set the timezone of metrics action, meaning that all dates will be based on passed timezone (including data fetched from GitHub, like commits)
  • #364 Improve apt process in Dockerfile
  • #372 Issue icons were replaced to match GitHub new design
  • #390 Upgrade to node 16
  • 174f2a27 Add delay option which temporises jobs (can be used to avoid reaching abuse limit)
  • 78a7c97f Add repositories_batch which control how many repositories are fetched at once (can be useful for users with a really lot of activity)

🧰 Fixes

• 37f686a ✨ Fix a fatal error which prevented insights from loading
• 1a52951 🧱 Fix broken config_output: json
• #379 🌐 Generated workflow configurations had some options which were invalid
• 98e7f05 💡 Runtime errors are now displayed in output
• #393 ⏰ Fix several Wakatime display issues
• #354 🗃️ Use correct timezone in footer
• #400 🌟 Unknown licenses are now displayed gracefully
• 5a15dfd 👨‍💻📰 Make login case insensitive
• #416 🈷️ Fix a case where undefiend file url made the plugin crash

💪 Contributors

• @lowlighter (maintainer)
• @PeterDaveHello https://github.com/lowlighter/metrics/pull/364
• @Zenoo https://github.com/lowlighter/metrics/pull/371 https://github.com/lowlighter/metrics/pull/373 https://github.com/lowlighter/metrics/pull/390
• @spenserblack https://github.com/lowlighter/metrics/pull/379
• @cherryblossom000 https://github.com/lowlighter/metrics/pull/392 https://github.com/lowlighter/metrics/pull/393
• @MatteoGheza https://github.com/lowlighter/metrics/pull/389
• @aw1cks https://github.com/lowlighter/metrics/pull/400
• @Nixinova https://github.com/lowlighter/metrics/pull/416

💕 Sponsors

♥️ Become a sponsor

📦 New features

• ↔️ Introducing larger display size ✨ new!
  • #310 You can now choose between regular (default) or large renders through config_display option
  • #310 Plugins may render differently depending on size chosen
    • It is advised to keep regular size if you want metrics to be displayed well both on mobile and desktop (as on mobile it may be rescaled down when displayed)
• 🈷️ Most used languages
  • #325 Add plugin_languages_indepth option to perform in-depth analysis of your languages statistics
    • This will clone your repositories, run github/linguist on them and iterate through matching git log entries. See plugins/languages/README.md before enabling
    • Use commits_authoring for better results
    • b0d37f3 Use npm run indepth to launch this tool locally on a given repository
  • #327 Add plugin_languages_sections and new "Recently used" section
    • Use plugin_languages_recent_load and plugin_languages_recent_days to customize how many events will be loaded and which time window should be used
  • #329 Add lines to plugin_languages_details to display an estimate of number of lines of code written (requires plugin_languages_indepth to be enabled)
• 🎩 Notable contributions
  • #293 Contributions are now sorted by most starred
• 📰 Recent activity
  • 2b9d8e8 Add plugin_activity_load to support a custom number of activity events to load
• 🎟️ Follow-up of issues and pull requests
  • #310 Repository template now displays closed pull requests like classic template
• 💡 Coding habits
  • fb745b4 Average characters per line of code is now displayed
  • #337 Texts improvements
  • dc271db Some changes in recent languages activity graph has been made to reflect languages plugin changes
• 🧑‍🤝‍🧑 People plugin
  • d2d5762 Default value for plugin_people_limit has been from 28 to lowered 24
• 🌐 Web instances
  • #299 Add copy button to action tab
• 🦑 Miscelleanous
  • aabb21f You can now use @main branch instead of @master branch
  • 6b129ab Text "forks" was changed to "forkers" in repositories base section to avoid confusion
  • 6b37fe4 dependabot-preview[bot] is now ignored by default
  • #308 config_padding now accepts absolute values
    • Default value has been changed for better SVG heights, you may need to re-adjust this option if you were using it
  • #326 Use config timezone in all displayed times
  • #336 Timezone metadata has been moved next to generated timestamp for better readability

🧰 Fixes

• 421a770 📰 Fix error when a push event has 0 commits
• 75978e8 📰 Fix forked repositories where target repository wasn't displayed
• #310 📰 Fix repository template display issues
• #310 🏅 Fix an issue where unknown commits author were crashing the plugin
• #310 📜 Fix an issue where licensed was returning an empty result which made the plugin crash
• dca7f76 🗃️ Fix affiliations constraint where authenticated user wasn't the target user
• #307 🗃️ Generated date now use defined timezone instead of GMT+0
• d25b286 🧱 Fix config_padding which was not handling well percentage values and was actually useless
• #347 🗨️ Fix an issue where comments count were marked as undefined
• #346 ✨ Fix a clipping issue on mobile

👏 Achievements

Reached 4+ millions downloads, 3 000+ stargazers and 1 000+ commits!
Thanks for your support 🎉 !

💪 Contributors

• @lowlighter (maintainer)
• @bokub https://github.com/lowlighter/metrics/pull/293
• @spenserblack https://github.com/lowlighter/metrics/pull/299
• @yutkat https://github.com/lowlighter/metrics/pull/315
• @Nixinova https://github.com/lowlighter/metrics/pull/326 https://github.com/lowlighter/metrics/pull/337 https://github.com/lowlighter/metrics/pull/336 https://github.com/lowlighter/metrics/pull/340 https://github.com/lowlighter/metrics/pull/347 https://github.com/lowlighter/metrics/pull/346

💕 Sponsors

♥️ Become a sponsor

📮 Send feedback on GitHub discussions

📦 New features

• ✨ Metrics insights

  • #291 Add introduction, followup and habits sections

• 📰 Recent activity

  • f9aa59b plugin_activity_limit is now able to load up to 1000 events instead of 100

🧰 Fixes

• 2958530 ⏰ Fix 404 error when user was not explicitely specified by plugin_wakatime_user
• 4ff4ef1 🏆 Remove debug logger
• 348827c 📰 Fix text display for repository creation event
• 348827c 📰 Published releases without name will display tag name instead
• a06ba37 💡 Fix event loader which was always loading 100 events less than expected
• 9ae1151 ✨ Fix links display for issue comments
• 50b93a7 🎟️ User query will only execute if account type is set to user
• 0759543🧱 Metrics won't fail if it cannot retrieve token scopes for metadata display

💪 Contributors

• @lowlighter (maintainer)

💕 Sponsors

📦 New features

• ✨ Metrics insights
  • #237 Improved markdown and code snippets rendering
  • #237 Empty comments are not displayed anymore
  • #262 GitHub urls for comments, issues and pull requests are now rendered with GitHub format
• 🎩 Notable contributions
  • #240 Add support for plugin_notable_filter to filter contributions (based on GitHub search query filter)
  • #240 Add support for plugin_notable_repositories to also display repository name along with organization name
• 📰 Recent activity
  • #237 Improved markdown and code snippets rendering
  • #242 Merge commits now display as a single commit
  • #244 Pushed commits are now display from most recent to oldest for more readability
• 🗨️ Stackoverflow plugin
  • #237 Improved markdown and code snippets rendering
  • #237 Use plugin_stackoverflow_lines_snippet to configure how many lines should be displayed
• 🎭 Comment reactions
  • #256 Add plugin_reactions_ignored to ignore reactions of user (defaults to github-actions[bot], dependabot[bot])
• 🏅 Repository contributors
  • #256 dependabot[bot] user is now ignored by default
• 📒 Markdown template
  • #263 SVG plugins can now directly be embed in a tempate without the need of creating separated jobs
    • Use <%- await embed({isocalendar:true}) %> to include an isocalendar for example
    • Rendered images are pushed to markdown_cache folder (defaults to .cache)
  • #270 This template can now be rendered as PDF file by using config_output: markdown-pdf
• 🦑 Miscelleanous
  • #238 Add support for extras_css option to let users inject raw CSS without template edition
    • For heavy styling, consider using community templates instead
  • #272 filename extension is now automatically deduced based on config_output value
  • #273 config_output now defaults to "auto" which will use the prefered template output (e.g. svg for classic, repository and terminal templates and markdown for markdown)
  • #273 Template now define which account type and output formats are supported and will throw an error in case of incompatibility
  • #273 Community templates can now use a template.mjs fallback from any official templates rather than just the classic one

🧰 Fixes

• #243 Fix No commits between error when a run resulted in no diff and tried to open a new pull request

💪 Contributors

• @lowlighter (maintainer)
• @Nixinova https://github.com/lowlighter/metrics/pull/242 https://github.com/lowlighter/metrics/pull/244 https://github.com/lowlighter/metrics/pull/262
• @MeerBiene https://github.com/lowlighter/metrics/pull/276

💕 Sponsors

✨ Introducing Metrics insights!

A web-tailored experience to see any user's metrics at a glance!
Use metrics.lecoq.io/about to share nice infographics with your friends or on social medias!
No configuration and login required!

Display rankings, highlights, commits calendar, used languages and recent activity with a single simple link using metrics.lecoq.io/about/your-github-username !

Don't hesitate to send feedback on GitHub discussions!

📦 New features

🧩 Plugins

• 🎩 Notable contributions ✨ new!
  • #222 Show that you contributed to large-scale projects thanks to the notable plugin!
• 📸 Website screenshot ✨ new!
  • #217 Use this plugin to display content from any website!
  • #217 Pass a CSS selector and an url and you can display random quotes, images or other stuff, like a random xkcd!
• 🏆 Achievements
  • #230 Add organization account support!
  • #214 Ranking is now more accurate and base itself on github.com/search for total entries
  • #214 Current ranks are now always displayed unless minimal requirements are not reached and would result in unprecise results
  • #214 Add new Inspirationer achievement for users with highly forked repositories
  • #230 Add new Sponsor achievement for users who sponsors other projects or people
• 🈷️ Most used languages
  • #228 Add support for plugin_languages_limit
• 🗨️ GitHub Community Support ✨ new!
  • #231 Display your statistics from GitHub Community Support

🖼️ Templates

• 📒 Markdown template ✨ new!
  • #209 Add new markdown feature that can template a custom markdown file with metrics data!
    • See a full example here of this powerful template!
  • #211 Add special markdown support for several plugins which includes hyperlinks and improved images rendering
    • Note: images below are rendered as PNG but are actually markdown texts
  • 📰 Recent activity
  • ✒️ Recent posts
  • 🗼 Rss feed
  • 🐤 Latest tweets
  • 📌 Starred topics

🌐 Web instances

• #215 Disabled plugins can now be checked to still preview "placeholder"
• #215 Actions and Markdown tabs are now available when you write an username instead of requiring a rendering
• #215 Add missing placeholder texts
• #215 Update Nightscout placeholder
• #228 You can now press Enter key in user input field to generate metrics instead of clicking on button
• #233 Web instances should now load faster, and have some visual improvement, including loading indicators
• 11a7bed Timeouts errors from GitHub API will now be explicitely displayed

🦑 Miscelleanous

• #212 Add support for gist in config_output option to let users upload their files to a gist instead of in their repositories
  • See documentation for more informations
• #227 token is now tested before rendering to early detect a possible invalid token
• 4892d69 Base option repositories_affiliations now allow multiple affiliations constraints
  • Following #232, if you're the token owner, both affiliations and ownerAffiliations constraints will be set instead of only ownerAffiliations for more accurate metrics

🧰 Fixes

• #211 Fix hashnode source posts offset
• #211 Fix a case where tweets with a single attachment was stripped out
• #218 Fix "merged" state in activity plugin
• #219 Update faker API
• #228 Fix locked achievements percentage display

🐛 Known issues

• plugin_tweets_attachments option may cause some issues on classic template
  • If you encounter display issues with it you can try to disable it, or use markdown version instead

💕 Sponsors

💪 Contributors

• @lowlighter (maintainer)
• @0xflotus made their first contribution in https://github.com/lowlighter/metrics/pull/235

👏 Achievements

Reached 2 millions downloads!
Metrics is around the 10kth most starred repository, and according to this tweet, it is the 2nd most starred Action on marketplace!
Thanks for your support 🎉 !

📦 New features

• 🗼 RSS feed plugin ✨ new!
  • #192 Add new plugin to display your own RSS feed!
• 💹 Stock plugin ✨ new!
  • #196 Add plugin to display the stock market price of your company!
• 🌇 GitHub Skyline 3D calendar
  • #198 Now use GIF instead of CSS animations hacks (breaks compatibility with some browsers but optimize performances)
  • #198 Use plugin_skyline_compatibility option to revert back to CSS animations hacks
• 🎟️ Follow-up of issues and pull requests
  • e4c560b Added a title to this plugin
• 🌐 Web instances
  • #191 Multiple requests are now merged in the same one instead of returning a 409 HTTP code
  • #193 Cache can now be set manually by users using cache value
• 🦑 Miscelleanous
  • 18c7fa1 Minor templates improvements
  • 8f4034a Add debug.headless option to debug puppeteer processes
  • 576d7aa SVGs are now formatted after generation to make them more human-readable
  • 18c7fa1 CSS for labels were updated with colors that blend wells with both light and dark modes

🧰 Fixes

• 13385ea Fix achievements percentage which was incorrect due to rescaling
• 5f6db8a Achievements now use pre-computed colors instead of filter css properties because it was unsupported on Safari
• 89182c6 Remaining requests are now displayed correctly on web instance
• #200 Resolve overflow-x bug on the footer (web instance)
• 1b844ae Fix web instance resize on already computed images (was breaking animations)
• ec80d0d Spotify tracks in playlist mode was displaying twice artist name
• addefee Refactor activity template to ensure text-overflow ellipsis
• 190dd39 Tweets plugin won't die when includes object is empty

💪 Contributors

• @lowlighter (maintainer)
• @Milo123459 https://github.com/lowlighter/metrics/pull/186
• @qinyihao https://github.com/lowlighter/metrics/pull/194
• @kimlimjustin https://github.com/lowlighter/metrics/pull/200

💕 Sponsors

📦 New features

• 🗨️ Stackoverflow plugin ✨ new!
  • #159 Add new stackoverflow plugin!
  • #159 Display various metrics about your stackoverflow account like your reputation, badges, questions, answers and comments
  • #159 Display your top answers and questions, along with your recently submitted answers and question
• 🎭 Reactions plugin ✨ new!
  • #180 Display overall users reactions of your latest comments!
• 🏆 Achievements plugin ✨ new!
  • #182 Display your achievements on GitHub!
  • #182 A few of them have actual ranking, and if you're in the top 100,000 you'll have an additional label beside!
  • #182 There are a few hidden achievements, will you be able to find them?
• 🐤 Tweets plugin
  • #164 Add plugin_tweets_attachments option to display tweets attachments
• ✒️ Recent posts plugin
  • #165 Add hashnode source
  • #165 Add plugin_posts_descriptions option to display posts intro/description
  • #165 Add plugin_posts_covers option to display cover images
• 🌇 GitHub Skyline 3D calendar
  • b064ed1 Add plugin_skyline_quality option to tune skyline animation quality (⚠️ significantly increase file size, use with caution)
• 🧑‍🤝‍🧑 People plugin
  • #166 Add plugin_people_sponsors_custom to let specify custom sponsors (intended for unsupported GitHub sponsors sources)
• 📅 Isometric calendar plugin
  • 442b83e Current streak is now displayed only when it's non-zero
  • 442b83e Best streak is now displayed
• 🦑 Miscelleanous
  • #158 Add config_gemoji option to render GitHub custom emojis like :octocat:
  • 8c16f54 Repository name for repository metrics can now be passed through repo option instead of query option
  • 8c16f54 committer_token now automatically defaults to ${{ github.token }} without the need of being set explicitly
  • #163 Migrated imgb64 to jimp for better optimization
  • 02ddae1 Add experimental_features option
  • 61e9bfc Add retries and retries_delay option to automatically retry failed rendering
  • 64fe0c8 @master images are now tagged with their version name
  • #175 when using lowlighter/metrics@master, images will now be pulled from GitHub container registry to save time and avoid rebuilding images
    • Set use_prebuilt_image to no to disable this feature
    • This options does not impact forks, where image will be rebuilt everytime to take into account eventual changes
  • #178 Add output_action option to configure output behaviour
    • It is now possible to open a pull request instead of committing directly rendered metrics
      • Generated pull requests can then be manually approved or auto-merged by the action
  • #178 Rendered metrics are now saved to /metrics_renders/${filename} which lets you perform other actions on it in your workflow
  • a2215a0 Add json type to config_output option which return all data gathered by metrics in a single JSON instead of rendering an image
  • c0f0363 Add committer_message option to use custom commit messages
    • If using commiter_token different from GITHUB_TOKEN, ensure you add [Skip GitHub Action] or handle correctly workflows skip to prevent infinite loop
• 🚧 Disabled features
  • #172 optimize option has been disabled due to display issues
    • It is possible to re-enable this option with experimental feature flag --optimize

🧰 Fixes

• 3eb0e30 Update played at text for music plugin
• #156 Normalize dates in plugins
• 8fe2220f Fix missing closing tag in tweets plugin
• 9e9b066 Fix missing closing tag in nightscout plugin
• 9e9b066 Error message for nightscout plugin is now displayed
• e52cefe Fix some cases where puppeteer instances were stuck indefinitely resulting in never-ending workflow runs
• 3e6c713 Fix lines plugin where it would fails on repositories with "null" authors

💪 Contributors

• @lowlighter (maintainer)
• @Milo123459 in https://github.com/lowlighter/metrics/pull/156 https://github.com/lowlighter/metrics/pull/184

💕 Sponsors

👏 Achievements

Reached 1 million downloads, 2.5k+ stargazers and 100+ forks!
Thanks to everyone 🎉 !

📦 New features

• 📜 Licenses plugin (repository plugin) ✨ new!
  • #118 Display permissions, limitations and conditions from your repository license along with inherited rules from used dependencies!
  • #118 plugin_licenses_ratio and plugin_licenses_legal lets you custom plugin output
• 🏅 Contributors plugin (repository plugin) ✨ new!
  • #126 Display contributors from between a range of commit or a single branch with plugin_contributors_base and plugin_contributors_head
  • #146 Display number of contributions per contributors with plugin_contributors_contributions and ignore bot users with plugin_contributors_ignored
• 🙋 Introduction plugin ✨ new!
  • #127 Display organization/repository description or user biography!
• 🌇 GitHub Skyline 3D calendar ✨ new!
  • #147 Display your animated 3D commits calendar from skyline.github.com
    • ⚠️ This plugin should be used as standalone because resulting image may be a few maga-bytes
    • ℹ️ Actual image is animated
• ⏰ WakaTime plugin ✨ new!
  • #90 Display your WakaTime statistics!
  • #90 plugin_wakatime_sections supports projects, languages, code editors and operating systems. Each categorie can be either displayed as a single entry, with graphs or both
• 💉 Nightscout ✨ new!
  • #108 Add new plugin which lets you display blood sugar values from Nightscout website!
• 🗃️ Base content
  • #124 Organization metrics now display location and "verified" status
• 🌸 Anilist
  • eb89bc3 Add plugin_anilist_limit_characters to limit displayed characters
  • #92 Add handling when rate limit is reached
• 🈷️ Most used languages
  • eb89bc3 Add plugin_languages_threshold to automatically hide languages used less than a certain threshold
  • a202469 Add plugin_languages_details support for repository template
  • #124 plugin_languages_skipped now supports non-owned repositories (prefix them with owner name)
• 🎼 Music plugin
  • #104 Add plugin_music_played_at to display when recently music was last played (Spotify only)
• 📰 Activity plugin
  • #119 Add plugin_activity_visibility to limit visibility to public events when using a repo scope token
  • #119 Add plugin_activity_timestamps to display events dates
  • #119 Add support for repository template now supports activity plugin
  • #119 Organization activity now display actor name
  • #119 Title are now ellipsed (...) instead of being cropped
• 🧑‍🤝‍🧑 People plugin
  • #124 Add members type for plugin_people_types to display organization members
  • #124 Add plugin_people_shuffle for varied output
• 🗂️ Active projects plugin
  • #124 plugin_projects_repositories now support mixed repositories owner (i.e. using organization-owned repositories project with an user account and vice-versa)
• 🌐 Web instances
  • #107 Improve placeholders for web instance inputs
  • #149 Compatible options for base and core are now displayed in sidebar
  • #149 Remove ratelimit-header for common resources, add footer and detailed error messages
• 🦑 Miscelleanous
  • #88 Splitted tests in respective plugins directory for easier maintaining
  • #91 Improved mocking of REST API octokit
  • #117 Add repositories_affiliations to restrict used repositories by owner, collaborator or member organization
    • ⚠️ Default affiliation will be set to owner instead of "" (rollback to behavior <= v3.1) to distorting metrics due to organization memberships
  • 5eaf603 Add npm run quickstart plugin and npm run quickstart template to ease metrics customization and new features
  • #121 Add config_twemoji option to replace emoji by twemoji for consistent rendering over all platforms
  • 1dd2d15 Display logs of raw commands for easier debug
  • @latest was moved from git tag to a git branch

🧰 Fixes

• 8e3ad79 Fix display issues for placeholder on web instance
• c42b9a2 Fix plugin_projects_limit option were a zero-value would remove all displayed projects, including repositories one
• #107 Music plugin now display recently music more accurately, and without duplicates
• #117 Habits plugin now correctly parse github/linguist for languages with special characters (e.g. C++)
• #117 Stargazers plugin now handle betters graphs when no ouput has been recorded
• #124 Fix issues with people plugin for organization
• 618d4a7 Web instance will now use correct default values for boolean inputs
• a63842f Fix config_output input for action
• bd8b980 Fix web instance Cache-Control header which was 1000 times higher than expected value
• d972f45 Fix optimize input for action

💪 Contributors

• @lowlighter (maintainer)
• @Milo123459 https://github.com/lowlighter/metrics/pull/104
• @legoandmars https://github.com/lowlighter/metrics/pull/108
• @L-Clem https://github.com/lowlighter/metrics/pull/144

📦 New features

• 🌸 Anilist plugin
  • #69 Display your favorite manga, anime and characters along with your watching list and activity from AniList
  • 
• 🈷️ Languages plugin
  • #72 Add new option plugin_languages_colors to use custom languages colors
    • #76 #77 Use predefined sets of colors
    • #87 Add plugin_languages_details to display additional details like total bytes sizes and percentages
    • 
• 🎧 Music plugin
  • #73 Add new provider lastfm to display recently listed tracks from Last.fm
  • #73 Add new option plugin_music_user to select music plugin target user (defaults to GitHub username)
• 🎫 Gists plugin
  • #74 Plugin can now support users with more than 100 gists
• 🗂️ Projects plugin
  • #75 Add new option plugin_projects_descriptions to display project's descriptions
• 🧑‍🤝‍🧑 People plugin
  • #78 Add support for repository template
  • #78 plugin_people_types now affects ordering of displayed sections
  • #78 plugin_people_types now support sponsors and sponsoring for users and contributors, stargazers, watchers and sponsors for repositories
  • #78 Add support for plugin_people
• 🌇 Organizations accounts
  • #81 Metrics is now compatible with organization account !
    • Most of plugins are compatible except a few one (see Compatibility Matrix for more informations)
    • You'll need to add read:org scope to your personal token (see documentation for more details)
  • #80 Add support for repository template owned by an organization account
  • 
• 🦑 Miscelleanous
  • #68 Add new option setup_community_templates to use templates from forks
    • See templates/community for more informations
  • #82 Refactor most of the code with a lot meta-programming
    • Most parts are now auto-loaded dynamically so there's no need to patch multiples files for new features additions
    • Plugins and templates now have their own README.md to not overload global one
  • #82 Action now reuse previously built images for forks and unreleased versions to save time in multiples jobs workflow
  • #83 Add support to pass token: NOT_NEEDED to skip core and base content, making it possible to use non GitHub-related plugins as standalone without a GitHub token

🧰 Fixes

• 1608b8b Fix an issue with topics plugins where when topics limit was not reached it displayed And 0 more...
• 524751c faker.js was wrongly flagged as dev-dependency
• c075d49 Fix repository template (was broken because of a change in setup)
• 5c3ecf9 GitHub cakeday is now displayed only for account and repositories older than one year
• 5619da4 Fix repository template when repository is empty
• 4763173 Fix stargazers plugin where it was only taking last 2 repositories (hardcoded test)

💪 Contributors

• @lowlighter (maintainer)
• @funkypenguin https://github.com/lowlighter/metrics/pull/63
• @raftario https://github.com/lowlighter/metrics/pull/73
• @b3z https://github.com/lowlighter/metrics/pull/76

👏 Achievements

Reached 100k+ downloads and 2k+ stargazers!
Thanks to everyone 🎉 !

📦 New features

• Added new Activity plugin !

  • Display all of your recent activity on GitHub, like :
    • Pushed commits
    • Opening/Reopening/Closing of issues and pull requests
    • Creation/Deletion of git tags or git branches
    • Pushed commits
    • Publication of new releases
    • Review of pull requests
    • Comments on commits, issues and pull requests
    • Edition of wiki pages
    • Forking and starring of repositories
    • Addition of new collaborators in a repository
    • Repositories made public
  • Limit displayed events with plugin_activity_limit and plugin_activity_days options
  • Filter displayed events with plugin_activity_filter
  • 

• Added new People plugin !

  • Display your followers and the users you're following on GitHub !
  • Use plugin_people_types to choose whether to displayed followers, following or both
  • 

• Miscelleanous

  • Added new option committer_branch to allow pushing generated metrics on a custom branch
  • Added new option config_order to order metrics content
  • Added new option repositories_forks to include forked repositories in metrics

• Repository template

  • Added support for pagespeed plugin
  • Added support for languages plugin
  • 

🦑 Miscellenous

• Fixed an issue where PageSpeed plugin was always resulting in 400 if no token was provided
• Fixed an issue with plugin_habits_days which was actually using the value of plugin_habits_from instead
• Fixed several visual issues with stargazers plugin
• config_padding can now be used to configure both height and width padding, instead of height only
• Removed constraint ownerAffiliations: OWNER to include organizations repositories in metrics
• Refactored mocked data with Faker.js
  • Placeholder on web instance are now rendered again client side with mocked data
• Simplied web instance home page for better browser support

💪 Contributors

• @lowlighter (maintainer)
• @crazyuploader https://github.com/lowlighter/metrics/pull/38
• @Nixinova in https://github.com/lowlighter/metrics/pull/44 https://github.com/lowlighter/metrics/pull/54
• @aleen42 in https://github.com/lowlighter/metrics/pull/51 https://github.com/lowlighter/metrics/pull/55

📦 New features

• Added new plugin stars !
  • Display your recently starred repositories !
  • 
• Added new plugin stargazers
  • Display your stargazers evolution across all of your repositories !
  • It even works with the repository template if you want to display the stargazers evolution of a single repo
  • 
• New redesign of the web instance !
  • 

💪 Contributors

• @lowlighter (maintainer)

📦 New features

• Gists plugin

  • Add new metrics files and comments
  • 

• Topics plugin

  • Add new option plugin_topics_mode
  • Add new mode mastered to display starred topics as Mastered technologies and topics with icons
  • Pass plugin_topics_limit: 0 to display all topics
  • 

• *PageSpeed plugin

  • Add new option plugin_pagespeed_screenshot to display a screenshot of audited website
  • 
  • Add new option plugin_pagespeed_url to specify a different website that the one attached to GitHub account

• Projects plugin

  • Add new option plugin_projects_repositories where you can list repositories projects
  • 

• Posts plugin

  • Add new option plugin_posts_user to specify a different user that the one attached to GitHub account
  • Fix display issue caused by the change of year

• Tweets plugin

  • Add new option plugin_tweets_user to specify a different user that the one attached to GitHub account

• Repository template

  • Add new template repository for specifically displaying additional metrics for a single repository
  • 

• Miscelleanous

  • Add support for users with more than 100 repositories
  • Improved support for Halloween
    • Add new --halloween debug flag
    • Isocalendar now support halloween colors
    • 
  • SVG heights are now computed dynamically to avoid cropped outputs and empty spaces
    • Use new option config_padding to adjust the size of your image in case you still have display issues
  • Add new option config_animations to allow disabling of animations
  • Add new option config_output to convert SVG into PNG/JPEG output
  • [Experimental] The action now use GitHub registry with already built images for released versions to decrease runtime (from ~5 min to < 30 secs)
    • Unreleased versions and forks will still rebuild the docker image each time

🦑 Miscellenous

• Heavy paths refactors
  • Everything was moved to /source
  • GraphQL queries is now in /source/queries
  • Web assets are now in /source/app/web
  • Action is now in /source/app/action
• GitHub action isn't built anymore and is called directlty with node
• Integration tests now use mocked data to avoid consuming APIs requests and to avoid the use of secrets
  • Refactor all tests with jest
• Templates and Plugins indexes are now loaded dynamically

💪 Contributors

• @lowlighter (maintainer)
• @joe733 https://github.com/lowlighter/metrics/pull/31

📦 New features

• Now celebrating your GitHub account registration with rainbows !
  • 
• Added new plugin tweets !
  • Display your recent tweets on your GitHub profile !
  • This use the twitter username you associated to your GitHub account
  • 
• Plugin habits has new features
  • plugin_habits_from max cap has been increased from 100 to 1000
  • plugin_habits_days allows you to filter the time window you want to keep, up to 30 days
  • plugin_habits_facts allows you to display tidbits deduced from your recent activity (previous behaviour)
  • plugin_habits_charts allows you to display charts of your commit/language activity !
  • 
• Add support for config_timezone/config.timezone
  • Configure a timezone for more accurate metrics !
• Terminal template
  • Now supports plugin_pagespeed_detailed option
  • Now supports plugin_gists option
• Added new debug_flags option

🦑 Miscellenous

• Removed opacity style which caused weird display issues on iOS
• Docker image has been updated
• Improved handling of plugins errors, most of external API now return the error message
• Added more logs

💪 Contributors

• @lowlighter (maintainer)

📦 New features

• Header now display Available for hire ! when you opted-in on your account
  • 
• Languages plugin has been updated
  • plugin_languages_ignored option allows you to ignore a comma-separated list of languages
  • plugin_languages_skipped option allows you to ignore a comma-separated list of repositories

🦑 Miscellenous

• GitHub action should now be able to update generated files larger than 1Mb
• Web instance has been updated
  • A lot of routes has been renamed
  • Remaining GitHub requests are now displayed in the bottom of screen
  • Missing plugins options were added
  • yml auto-generated for action config was updated

💪 Contributors

• @lowlighter (maintainer)

📦 New features

• GITHUB_TOKEN is now supported, no need to use token with additional permissions, yay 🎉
  • plugin_selfskip has been removed since it's now useless

🦑 Miscellenous

• Updated documentations (fix typo, updated images and steps, etc.)

💪 Contributors

• @lowlighter (maintainer)

📦 New features

• Plugin pagespeed

  • Add new option plugin_pagespeed_detailed to display additional pagespeed audits result
  • 

• Web instance improvements

  • Display display version number
  • Use prefers-color-scheme browser setting to auto-select appropiate color scheme
  • Add support for pagespeed.detailed
  • Style improvements

🦑 Miscellenous

• Debug log are now displayed in case of action error
• Workflow test cases are now generated and tests master and latest
• Renamed in code all computed.plugins to plugins to be less verbose
• Fix handling of boolean string in web instance (always considered as truthy)
• Additional checks where added to PageSpeed plugins

💪 Contributors

• @lowlighter (maintainer)

📦 New features

• Add new plugin topics
  • Display your starred topics from GitHub topics !
  • 
• Add new plugin projects
  • Display your personal projects progress !
  • 
• Plugin isocalendar
  • Add new option plugin_isocalendar_duration which can be set to half-year (default) or full-year

🦑 Miscellenous

• Fix placeholder image for web instance
• Fix base option for both web instance and GitHub action

💪 Contributors

• @lowlighter (maintainer)