Guide

How does GitHub Trending work, and can you get on it?

Updated July 19, 2026 · WarmStars

Short answer

GitHub Trending ranks repos by the stars they gained in one recent window (today, this week, or this month), not their all-time total. So a small project with a real burst can outrank a stalled giant. Yes, you can land on it: concentrate genuine attention into a tight window. You cannot fake it. Bought stars get filtered and wreck the signal.

  • Trending measures momentum (stars gained in a window), not lifetime totals. A fresh burst beats a big stale number.
  • Two dials: time window (today, this week, this month) and language. A specific language is a smaller field you can actually win.
  • You get there by firing your reach close together: a Show HN, the right subreddit, your list, all in one day.
  • After the spotlight, a wave of new stargazers lands. [Catch who they are](/guides/see-who-starred-your-github-repo), do not just watch the count climb.

What does GitHub Trending actually measure?

Get this one thing straight first, because it flips how the whole page works. Trending does not care how many stars you have. It cares how many you just got. It watches a recent window (today, this week, this month) and ranks repos by the climb inside that window, not the pile you have built over the years.

Which means momentum beats mass. Say acme/rocketdb has 400 stars and picks up 90 of them on a Tuesday. It can sit above a 30,000-star project that has gone quiet and gained four stars that day. The stalled giant is basically invisible here. The little repo with a real spike is the story of the day.

You can see the shape of that on a star history chart: a burst is the curve going near-vertical for a stretch. Trending is that curve, caught live. A flat line, no matter how high up the page it sits, does nothing for you.

How do the filters work, and which one is winnable?

Two dials sit at the top of the Trending page: the time window (today, this week, this month) and the programming language. Change either one and you are looking at a different leaderboard entirely.

The window sets how forgiving the math is. "Today" is a knife fight, you need the stars inside a single day. "This week" and "this month" spread the same gain across more time, so a slower, steadier climb can still surface. If you cannot get one giant day, aim for the wider windows.

The language filter is the one most people ignore, and it is the one you can actually win. The all-languages board is the whole planet fighting for a handful of slots. The page for one specific language, especially a less crowded one your project genuinely lives in, is a much smaller field. Fewer repos competing for the same seats. If your project has a natural language home, that is where your odds of showing up are best.

How do you actually get on GitHub Trending?

Here is the honest mechanic answer: you do not trickle your way on, you spike. Trending rewards concentration. The same 100 stars dripped out over a month do nothing. Those same 100 stars in one afternoon can put you on the board.

So you fire your reach close together, on purpose. A Show HN post. The right subreddit for your niche (one where the project actually belongs, not spray-and-pray). Your newsletter, your launch list, a good thread, a founder friend with an audience. Line them up for the same day instead of spacing them out politely over two weeks. For the channels themselves, see how to promote your GitHub project and how to get more GitHub stars.

And the boring part everyone skips: the repo has to be ready to convert the click. A README that says what this is in one screen. A clear demo or a screenshot. A reason to hit star in the first eight seconds. Reach gets people to the page. The page earns the star. Do not spend your one spike sending traffic to a wall of text.

Can you fake your way onto Trending?

Short version, no. And I would stop you at the door before you spent a dollar on it.

GitHub filters fake bursts. A wall of brand-new, empty accounts starring you in the same hour is the exact pattern their spam detection was built to catch, so bought stars get discounted or stripped out. You can spend real money and move nothing on the board.

But the deeper reason is the one that actually costs you. A star is a signal you are supposed to use later, and bought stars poison the well. Real developers can smell a graph that jumped 2,000 in a night with zero forks, zero issues, and zero conversation. It reads as fraud, which is a worse look than being small and honest. And the accounts behind fake stars are bots: they will never open an issue, never file a PR, never become a user. You would be inflating the one number that is meant to point you at real humans. The whole value of a star is the person attached to it. Fake stars are numbers with nobody home.

What happens after you trend, and how do you not waste it?

Now the good part. A Trending slot is a spotlight, and the spotlight sends a wave: new visitors, new stars, a day where more people find you than in the previous three months combined. Hold onto this, because it is the whole payoff: every one of those stars is a person who just raised their hand at your project.

The count is the aggregate. It tells you how many, which is great for a screenshot and close to useless on its own. The value is the who. dev-priya starred acme/rocketdb the day it trended because she has the exact problem you solve. She is not a data point, she is a potential first user, and right now she is a name you have not met yet.

So catch the wave while it is warm. Your first users are the developers who starred you, and there is a public email for many of them. A tool like WarmStars turns your OWN repo's stargazers into a named list from public data, so a Trending day becomes real conversations instead of a number that peaks on Tuesday and fades by Thursday. Start with seeing who starred your repo and go from there.

Here is the catch, and it is a friendly one: Trending is a moment, not a business. It cools in a day or two no matter what you do. The projects that win are not the ones that trended, they are the ones that were ready to talk to the crowd it brought. Get the spike. Then go meet the people it hands you.

0
all-time stars that help you trend. GitHub Trending only ranks the stars you gained in the window, nothing else.

Common questions

Does GitHub publish the exact Trending formula?
No. GitHub has never documented the precise math, and it has shifted over time. What holds true: it ranks recent star growth inside your chosen window and filters obvious spam. Do not overfit to a secret formula. Concentrate real attention into a tight window and let the ranking do its job.
How long do you stay on GitHub Trending?
Not long. It is a rolling window, so as your burst cools you slide down and off. A strong day can hold you on the "today" board for hours and the weekly board a little longer. Treat it as a moment to capitalize on, not an address you live at.
Does filtering by language really help a small project?
Yes, it is your best angle. The all-languages board is a global fight for a few slots. A single language page, especially a less crowded one your project actually belongs to, is a much smaller field with fewer repos competing for each seat. Same stars, far better odds of being seen.
Do forks and watchers count toward Trending?
Trending is driven mainly by the stars you gain in the window. Forks and watchers are genuine signs of a healthy project, and developers absolutely look at them, but the ranking you see is about star growth. Point your spike at stars, and keep the rest of the numbers honest so the picture holds together.
Will buying stars get me onto Trending?
No, and it can backfire. Fake bursts from empty accounts are exactly what GitHub's spam filtering targets, so bought stars get discounted or removed. Worse, they poison the one number that is supposed to point you at real people, and experienced developers spot a fraudulent graph fast. Skip it entirely.
I trended but got no users. What went wrong?
Trending handed you a crowd, which is the aggregate: how many. The value is the who. Those stargazers are named developers who just raised their hand at your project. If you only watched the count climb, you walked right past them. Turn that wave into a named list and start conversations while it is still warm.
get started

Meet the people behind your stars.

Free to start. Two scans a month, no credit card.