Guia de consumo

Exiba a adoção real do seu open source no seu site.

Cadastre seus repositórios uma vez e mostre os números vivos — clones e downloads acumulados e auditáveis — com um widget, um badge ou a API pública. Herda a fonte e a cor do seu site.

🔓 API pública · CORS liberado · sem chave

Parte A · Cadastrar seus dados

Conecte seus repositórios

Primeiro o serviço precisa medir a adoção dos seus repos. Leva cerca de 1 minuto e o acesso é sempre somente leitura.

1

Entre no painel

Acesse gitadoptionmeter.com/app e faça login. Você verá o card “Conexão com o GitHub”.

2

Escolha um plano

No card “Plano e cobrança”, escolha pelo número de repos: Amador (1) · Semi-Pro (10) · Pro (25) · Team/Org (60) · Enterprise (150). Mensal ou anual (pagamento online em breve via CodeDogfooding).

3

Conecte o GitHub App

Clique em “Conectar GitHub App”, escolha “Only select repositories”, confira o bloco “✓ Read access…” (somente leitura) e clique em “Install”.

4

Pronto — cada repo ganha uma key

O GitHub te devolve ao painel com “Método ativo: GitHub App”. A coleta roda 1×/dia e cada repo recebe uma key (ex.: ZIMARO) — é ela que você usa na Parte B.

🔒 Sempre somente leitura

O GitHub App só lê a Traffic API (clones), conta downloads de assets de Release e identifica o repositório. Nunca escreve em código, issues ou configurações — e você desconecta com um clique. Detalhes em gitadoptionmeter.com/guia.

Parte B · Consumir e exibir

Mostre os números no seu site

Escolha uma superfície: o widget (inline, logo, gráfico 3D, bloco ou dashboard), o badge para o README ou a API em JSON.

5

Inclua o script uma vez

Antes de </body>. Opcional: data-lang="auto" (detecta PT/EN/ES).

<script src="https://gitadoptionmeter.com/widget.js" defer></script>
6

Escolha uma superfície de embed

Use a key do seu repo. O widget herda a fonte e a cor do host.

<!-- inline number -->
<strong data-gam-repo="ZIMARO">1.598</strong>

<!-- repo logo -->
<span data-gam-logo="ZIMARO"></span>

<!-- 3D chart icon -->
<span data-gam-chart-for="ZIMARO"></span>

<!-- full block (logo + number + label + link + chart) -->
<div data-gam-block="ZIMARO" data-gam-metric="total"></div>

<!-- dashboard -->
<div id="gitadoptionmeter"></div>
  • data-gam-metric: total | clones | downloads | current
  • data-gam-format: full | short
  • data-gam-label, data-gam-url, data-gam-link="false"
7

Ou um badge no README

SVG estilo shields, sem script. Query: ?label=, ?color=, ?metric=, ?format=.

![adoption](https://gitadoptionmeter.com/badge.svg)
![clones](https://gitadoptionmeter.com/badge/ZIMARO.svg?metric=clones&label=clones)
8

Ou consuma a API

JSON público, CORS liberado. Traz grandTotal, products[] (com key, url, iconUrl, views…) e mais.

GET https://gitadoptionmeter.com/api/adoption

Checklist final

Comece agora

Cadastre seus repos e exiba tração honesta para sempre.

Ir para o painel → Ver a demo gitadoptionmeter.com/app