// passive growth loop

Turn your README
into a billboard.

Drop one line into your README. Every developer who reads your repo sees that you ship with AI code review. No tokens. No config. Updates every 5 minutes.

Install PullLight free → Get your badge ↓

Why this works

Shields.io badges drove organic discovery for Codecov, Snyk, and Dependabot. Same mechanic — different category.

📡

Every README is a billboard

Your repo's README is read by contributors, employers, users. One badge surfaces PullLight to all of them — passively.

⚡

Auto-updates, zero maintenance

The badge URL is live. It pulls fresh data every 5 minutes. You never update a screenshot or a count.

🔗

Click-through to your catch history

Badge links to your public repo page. Curious engineers click through, see real findings, and evaluate PullLight.

🏆

Social proof for your team

"Reviewed by PullLight" signals code quality. Shows contributors their PRs are read carefully before merge.

Three states, automatic

One badge URL. The state is determined from your repo's install status and review history — no query params needed.

Active — bugs found

Installed and PullLight has caught N issues. Count rises with each new finding. Links to your public catch history.

Active — no catches yet

Installed. PullLight is reviewing PRs. No issues found yet — signals you take code quality seriously from day one.

Not installed — drives installs

Repo not yet using PullLight. Contributors see it and click to install. A conversion funnel from your README.

How it looks in the wild

Four examples showing the badge alongside common README patterns.

◈ acme-corp / api-gateway Node.js API gateway

api-gateway

High-performance API gateway for Node.js microservices. Rate limiting, JWT auth, request routing.

◈ startup-xyz / deploy-cli New open-source project

deploy-cli

Zero-config deploy CLI for container workloads. Works with Docker, Kubernetes, and Fly.io.

Contributing

PRs welcome. All pull requests are reviewed by PullLight before merge.

◈ my-company / backend-services Before installing PullLight

backend-services

Monolith backend for our main product. PostgreSQL + Express + Redis.

◈ oss-project / data-pipeline Active OSS project, many PRs

data-pipeline

Streaming data pipeline for high-volume event processing. Kafka + Flink + PostgreSQL.

Code Quality

PullLight reviews every PR before merge. 142 bugs caught and fixed to date.

Get your badge

Enter your repo. Copy the snippet. Drop it at the top of your README.

Personalize your badge

Paste your GitHub owner and repo — the snippet updates live.

GitHub owner

Repository name

Markdown (README.md)

[![PullLight](https://pulllight.io/badge/{owner}/{repo}.svg)](https://pulllight.io/repos/{owner}/{repo})

HTML (docs sites)

reStructuredText (.rst)

.. image:: https://pulllight.io/badge/{owner}/{repo}.svg :target: https://pulllight.io/repos/{owner}/{repo} :alt: PullLight

Don't have PullLight yet?

Install in 30 seconds. Connect your GitHub repo. First review runs on your next open PR — no config file, no credit card.

Install PullLight free → See real bugs caught →

Machine-readable feeds

For newsletters, dashboards, and embed widgets — PullLight offers a JSON feed and RSS feed updated from the catches database.