https://github.com/carolyn-sun/simple-lang-stats

Enjoy simplicity. A GitHub Action that automatically generates and updates language statistics in your README profile.
https://github.com/carolyn-sun/simple-lang-stats

readme-profile statistics stats

Last synced: 4 months ago
JSON representation

Enjoy simplicity. A GitHub Action that automatically generates and updates language statistics in your README profile.

• Host: GitHub
• URL: https://github.com/carolyn-sun/simple-lang-stats
• Owner: carolyn-sun
• License: mit
• Created: 2025-11-04T17:31:39.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2026-02-23T00:10:56.000Z (4 months ago)
• Last Synced: 2026-02-23T05:46:16.894Z (4 months ago)
• Topics: readme-profile, statistics, stats
• Language: TypeScript
• Homepage:
• Size: 799 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Simple Language Stats

Enjoy simplicity. A GitHub Action that automatically generates and updates language statistics in your README profile.

```

57.72% ===   JavaScript

 31.6% ==    Fluent

 4.74% =     CSS

 1.77% =     MDX

  1.3% =     Astro

 1.09% =     HTML

 0.55% =     TypeScript

 0.43% =     Swift

 0.35% =     Julia

 0.18% =     Shell

  0.1% =     Typst

 0.08% =     XSLT

 0.05% =     Ruby

 0.04% =     PowerShell

```

*Based on 13 non-forked repositories for Carolyn Sun (carolyn-sun)
Powered by [carolyn-sun/simple-lang-stats](https://github.com/carolyn-sun/simple-lang-stats)*

## Usage

Set a `PAT` secret in your repository settings in case you reach the API rate limit. `Repo` scope is sufficient.

Add this marker to your README.md where you want the language statistics to appear:

```markdown

```

The action will automatically insert your language statistics between these markers.

Then, add it to your workflow file (e.g., `.github/workflows/update-stats.yml`):

```yaml

name: Update language stats

on:

  push:

  schedule:

    - cron: '0 */48 * * *'  # Run every 48 hours

  workflow_dispatch:  # Allow manual trigger

jobs:

  update-stats:

    runs-on: ubuntu-latest

    permissions:

      contents: write  # Allow writing to repository contents

      

    steps:

      - name: Checkout

        uses: actions/checkout@v4

        with:

          token: ${{ secrets.GITHUB_TOKEN }}

        

      - name: Update Language Stats

        uses: carolyn-sun/simple-lang-stats@latest

        with:

          PAT: ${{ secrets.PAT }}

          username: ${{ github.repository_owner }}

          

      - name: Commit changes

        run: |

          git config --local user.email "action@github.com"

          git config --local user.name "GitHub Action"

          git add README.md

          git diff --staged --quiet || git commit -m "Update language statistics"

          git push

```