Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rahuletto/gitmystat

🎨 Turn your GitHub activity into sleek stats and cool visuals
https://github.com/rahuletto/gitmystat

git github github-readme-stats readme statistics stats

Last synced: 3 months ago
JSON representation

🎨 Turn your GitHub activity into sleek stats and cool visuals

Awesome Lists containing this project

README

        

![gitmystat](/assets/gitmystat.png)

# gitMyStat!

~~Get~~ Git my stat! 🎨 Turn your GitHub activity into sleek stats and cool visuals

> Inspired by a great project [github-readme-stats](https://github.com/anuraghazra/github-readme-stats/)

> [!TIP]
> Lazy to read alot just for readme? Me too!
> Thats why I made a [Builder](https://gitmystat.vercel.app#builder) which generates the cards for your parameters. Give it a try!

## Table of Contents

- [Parameters](#parameters)

- [Cards](https://gitmystat.vercel.app#config)
- [User](#user)
- [Recent repos](#recent-repo)
- [Repo card](#repo-card)
- [Top languages](#top-languages)
- [Wakatime](#wakatime)

- [Themes](https://gitmystat.vercel.app#themes)

---

## Parameters

All cards are built equally. Which means these apply to every card possible

| Parameters | Description | Default |
| ---------- | --------------------------------- | ------- |
| `username` | The username to get the data from | |
| `theme` | The theme to apply on the cards | dark |

### Customizations

> [!IMPORTANT]
> As url encoding messes up the # tag character, we wanted you to provide a hexadecimal code instead.
>
> ### `What's that?!`
>
> Nothing actually. instead of `#` we use `0x`.
>
> For example
>
> `#000000` is the same as `0x000000` > `#075fff` is the same as `0x075fff`

| Parameters | Description |
| ------------ | -------------------------------------------------- |
| `color` | The hexadecimal color of the text color |
| `accent` | The hexadecimal color of the accent color |
| `background` | The hexadecimal color of the background |
| `border` | The hexadecimal color of the border |
| `tip` | The hexadecimal color of the tertiary (tips) color |
| `radius` | The radius of the border |
| `padding` | The padding of the border |

- Totally decked out example

```
![image](https://gitmystat.vercel.app/recent?username=rahuletto&color=0xaeaeae&accent=0x075fff&background=0x000000&border=0x075fff&tip=0x075fff&radius=12&padding=24)
```

![image](https://gitmystat.vercel.app/recent?username=rahuletto&color=0xaeaeae&accent=0x075fff&background=0x000000&border=0x075fff&tip=0x075fff&radius=12&padding=24)

> [!TIP]
>
> Adding `theme={theme}` in the url would change the theme of any card
>
> For example
>
> - `https://gitmystat.vercel.app/recent?username=rahuletto&theme=gold`
>
> ![recent theme](https://gitmystat.vercel.app/recent?username=rahuletto&theme=gold)

---

## Cards
- [User](https://gitmystat.vercel.app#config)
- [Recent repos](https://gitmystat.vercel.app#config)
- [Repo card](https://gitmystat.vercel.app#config)
- [Top languages](https://gitmystat.vercel.app#config)
- [Wakatime](https://gitmystat.vercel.app#config)

> [!WARNING]
> For wakatime, We are using WakaTime api, which only displays for profiles that are public. Make sure the `Display code time publicly` and `Display languages, editors, os, categories publicly` are enabled.

---

## Themes
Visit the [themes page](https://gitmystat.vercel.app#themes)!

> #### You like a theme, but you just don't like that particular color?
>
> It's alright! the parameters can override particular colors of the theme while keeping the other colors the same from the theme.

### Extend it.

These themes are not hard coded. You can add your own!
You have a great color palette? **PLEASE** do a pull request on our repo and make it a reality.

> [!NOTE]
> If you are making a theme, please make a light mode version of it too. This is not mandatory to do, but it's a good thing to have more flavors.

#### `How?`

- Go to `/themes/index.ts`

```ts
themename: {
color: '#hex',
accent: '#hex',
background: '#hex',
border: '#hex',
tip: '#hex',
radius: 24,
padding: 24,
},
```

- Change the `themename` to the name you prefer
- Change the color hex codes of the things, localhost would be great to test it
- Push it, Do a pull request.

It's that simple.