{"id":27386277,"url":"https://github.com/igorkowalczyk/github-views","last_synced_at":"2025-04-13T17:18:10.195Z","repository":{"id":65764992,"uuid":"581561307","full_name":"IgorKowalczyk/github-views","owner":"IgorKowalczyk","description":"👀 Count the views of your Github profile with your own custom badge","archived":false,"fork":false,"pushed_at":"2025-04-13T13:16:20.000Z","size":5864,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-13T17:18:01.744Z","etag":null,"topics":["astrojs","deno","github","github-views","profile","profile-views","typescript"],"latest_commit_sha":null,"homepage":"https://views.igorkowalczyk.dev","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IgorKowalczyk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/codeowners","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["igorkowalczyk"]}},"created_at":"2022-12-23T14:55:22.000Z","updated_at":"2025-04-13T13:16:22.000Z","dependencies_parsed_at":"2023-02-21T00:00:17.715Z","dependency_job_id":"2e6e6623-ae7d-4d22-97d2-4a48c01c19f6","html_url":"https://github.com/IgorKowalczyk/github-views","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IgorKowalczyk%2Fgithub-views","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IgorKowalczyk%2Fgithub-views/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IgorKowalczyk%2Fgithub-views/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IgorKowalczyk%2Fgithub-views/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IgorKowalczyk","download_url":"https://codeload.github.com/IgorKowalczyk/github-views/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750123,"owners_count":21155687,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astrojs","deno","github","github-views","profile","profile-views","typescript"],"created_at":"2025-04-13T17:18:09.545Z","updated_at":"2025-04-13T17:18:10.179Z","avatar_url":"https://github.com/IgorKowalczyk.png","language":"Vue","readme":"![Github Profile Views](https://github.com/IgorKowalczyk/github-views/assets/49127376/1e3f22d5-5fbd-41ff-bd6f-4aee9dfae847)\n\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca aria-label=\"GitHub License\" href=\"https://github.com/igorkowalczyk/github-views/blob/main/license.md\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/igorkowalczyk/github-views?color=blue\u0026logo=github\u0026label=License\"\u003e\n  \u003c/a\u003e\n  \u003ca aria-label=\"Version\" href=\"https://github.com/igorkowalczyk/github-views/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/igorkowalczyk/github-views?color=blue\u0026logo=github\u0026label=Version\"\u003e\n  \u003c/a\u003e\n  \u003ca aria-label=\"Powered by\" href=\"https://workers.cloudflare.com/\"\u003e\n    \u003cimg src=\"https://img.shields.io/static/v1?label=Powered%20by\u0026message=Cloudflare+Workers\u0026color=blue\u0026logo=cloudflareworkers\"\u003e\n  \u003c/a\u003e\n  \u003ca aria-label=\"Powered by\" href=\"https://astro.build\"\u003e\n    \u003cimg src=\"https://img.shields.io/static/v1?label=Powered%20by\u0026message=Astro\u0026color=blue\u0026logo=astro\u0026logoColor=fff\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n\u003e [!NOTE]\n\u003e Don't forget to replace example `YOUR-USERNAME` parameter with real value.\n\n## ✨ Basic usage\n - Go to https://views.igorkowalczyk.dev and enter your Github username or any other text\n - Copy the generated markdown code with the style you like and paste it in your `README.md` file\n \n```markdown\n![Github Views](https://views.igorkowalczyk.dev/api/badge/YOUR-USERNAME)\n```\n\n## 🖼️ Available styles\n\n\u003e [!NOTE]\n\u003e The default style is `flat`\n\n| Style | Example | Usage |\n| ----- | ---- | ---- |\n| `flat` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true) | `style=flat` |\n| `classic` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=classic\u0026display=true) | `style=classic` |\n\n\u003e [!NOTE]\n\u003e To apply the style, add to the URL `?style=YOUR-STYLE`, if you use other parameters you can use `\u0026style=YOUR-STYLE`\n\n## 🎨 Custom colors\n\n\u003e [!NOTE]\n\u003e The default color is `blue`\n\n| Color | Example | Usage | Label Color | Label usage | \n| ----- | ---- | ---- | ---- |  ---- | \n| `blue` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=blue) | `color=blue`  | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=blue) | `labelColor=blue` |\n| `cyan` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=cyan) | `color=cyan` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=cyan) | `labelColor=cyan` |\n| `green` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=green) | `color=green` |  ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=green) | `labelColor=green` |\n| `yellow` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=yellow) | `color=yellow` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=yellow) | `labelColor=yellow` |\n| `orange` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=orange) | `color=orange` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=orange) | `labelColor=orange` |\n| `red` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=red) | `color=red` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=red) | `labelColor=red` |\n| `pink` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=pink) | `color=pink` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=pink) | `labelColor=pink` |\n| `purple` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=purple) | `color=purple` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=purple) | `labelColor=purple` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=gray) | `labelColor=gray` |\n| `gray` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=gray) | `color=gray` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=gray) | `labelColor=gray` |\n| `black` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=black) | `color=black` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=black) | `labelColor=black` |\n| `ff69b4` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026color=ff69b4) | `color=ff69b4` | ![](https://views.igorkowalczyk.dev/api/badge/example?style=flat\u0026display=true\u0026labelColor=ff69b4) | `labelColor=ff69b4` |\n\n\u003e [!NOTE]\n\u003e To apply the style, add to the URL `?color=YOUR-COLOR`, if you use other parameters you can use `\u0026color=YOUR-COLOR`\n\n\u003e [!WARNING]\n\u003e HEX colors should be used without `#` symbol prefix.\n\n\n## 📊 Number format\n\nYou can display the number of views in a more readable format. You can choose between `short` and `long` format.\n\n| Format | Example | Usage |\n| ----- | ---- | ---- |\n| `short` | ![](https://views.igorkowalczyk.dev/api/badge/igorkowalczyk?style=flat\u0026display=true\u0026format=short) | `format=short` |\n| `long` | ![](https://views.igorkowalczyk.dev/api/badge/igorkowalczyk?style=flat\u0026display=true\u0026format=long) | `format=long` |\n\n\u003e [!NOTE]\n\u003e To apply the style, add to the URL `?format=YOUR-FORMAT`, if you use other parameters you can use `\u0026format=YOUR-FORMAT`\n\n## 📝 Custom text\n\nYou can overwrite default `Views` text with your own label.\n\n![](https://views.igorkowalczyk.dev/api/badge/example?label=Your+own+label\u0026display=true\u0026color=blue)\n\n```markdown\n![Github Views](https://views.igorkowalczyk.dev/api/badge/YOUR-USERNAME?label=Your+own+label)\n```\n\n\u003e [!NOTE]\n\u003e Replace whitespace with `+` character in multi-word labels.\n\n## 📦 `JSON` format\n\nYou can get the number of views in `json` format. It can be useful if you want to use the number of views in your application.\n\n\u003e [!WARNING]\n\u003e The API is read-only, you can't change the number of views.\n\n**Request:**\n```\nhttps://views.igorkowalczyk.dev/api/json/YOUR-USERNAME\n```\n\u003e [!NOTE]\n\u003e Replace `YOUR-USERNAME` with your real value.\n\n**Response:**\n```json\n{ \"views\": 123 }\n```\n\n---\n\n## 🔩 Local Development\n\n1. Clone [this repository](https://github.com/igorkowalczyk/github-views) `git clone https://github.com/IgorKowalczyk/github-views.git`\n2. Run `pnpm i` to install all dependencies,\n3. Edit the `wrangler.jsonc` file with your values\n4. Run `pnpm types` to generate types for the project\n5. Run `pnpm dev` to start the development server or `pnpm preview` to preview the production build\n\n\n## 🖥️ Hosting with Cloudflare Workers\n\n1. Clone [this repository](https://github.com/igorkowalczyk/github-views) `git clone https://github.com/IgorKowalczyk/github-views.git`\n2. Run `pnpm i` to install all dependencies,\n2. Go to [Cloudflare Workers](https://workers.cloudflare.com/) and create a new project (you can import the project from GitHub)\n3. Go to Cloudflare \u003e Storage \u0026 Databases -\u003e KV -\u003e Create, and create a new KV namespace\n3. Link the KV namespace to the project in the `wrangler.jsonc` file\n4. Edit the `wrangler.jsonc` file with your values\n4. Run `pnpm types` to generate types for the project\n5. Run `pnpm dev` to start the development server or `pnpm preview` to preview the production build\n5. If you want to deploy the project, run `pnpm check` to check the project and `pnpm deploy` to deploy the project to Cloudflare Workers\n\n\u003e [!NOTE]\n\u003e Refer to the [Cloudflare Workers documentation](https://developers.cloudflare.com/workers) and [Wrangler documentation](https://developers.cloudflare.com/workers/tooling/wrangler) for more information.\n\n## ⁉️ Issues\n\nIf you come across any errors or have suggestions for improvements, please create a [new issue here](https://github.com/igorkowalczyk/github-views/issues) and describe it clearly.\n\n## 📥 Pull Requests\n\nWhen submitting a pull request, please follow these steps:\n\n- Clone [this repository](https://github.com/igorkowalczyk/github-views) `https://github.com/IgorKowalczyk/github-views.git`\n- Create a branch from `main` and give it a meaningful name (e.g. `my-awesome-new-feature`).\n- Open a [pull request](https://github.com/igorkowalczyk/github-views/pulls) on [GitHub](https://github.com/) and clearly describe the feature or fix you are proposing.\n\n## 📋 License\n\nThis project is licensed under the MIT. See the [LICENSE](https://github.com/igorkowalczyk/github-views/blob/main/license.md) file for details\n","funding_links":["https://github.com/sponsors/igorkowalczyk"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorkowalczyk%2Fgithub-views","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figorkowalczyk%2Fgithub-views","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorkowalczyk%2Fgithub-views/lists"}