gingiris-github-star-growth

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GitHub Star 持续增长实操手册

GitHub Star Sustained Growth Playbook

⚠️ Scope Differentiation:
gingiris-opensource
= Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).

⚠️ Scope Differentiation:
gingiris-opensource
= Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).

Star 地区分布 & 发布时序

Star Geographic Distribution & Launch Timeline

适用于 launch 阶段(和
gingiris-opensource
配合使用)
  • 同一国家/地区 star 占比不超过 20%,是上 GitHub Trending 的隐性门槛。
  • 工具:star-history.com(涨幅趋势)· OSS Insight(国家分布,国人开发)
  • 发布时序:第一周海外宣发,第二周才做国内(朋友圈 / 中文社群)。
    • AFFiNE 真实案例:开源第一周拿 6000 star,几乎全来自海外渠道。
  • 陪跑好的项目节奏参考:至少提前 2-3 个月准备; 爆发期一周 4000-6000 star,三周可达 10000 star
Applicable for the launch phase (to be used with
gingiris-opensource
)
  • No single country/region should account for more than 20% of stars, which is an implicit threshold for getting on GitHub Trending.
  • Tools: star-history.com (growth trend) · OSS Insight (geographic distribution, developed by Chinese developers)
  • Launch sequence: Overseas promotion in the first week, domestic promotion (Moments / Chinese communities) only in the second week.
    • AFFiNE real case: Gained 6000 stars in the first week of open-sourcing, almost all from overseas channels.
  • Reference rhythm for well-supported projects: Prepare at least 2-3 months in advance; 4000-6000 stars in the burst week, reaching 10000 stars in three weeks.

Star 地域分布健康基准

Healthy Benchmark for Star Geographic Distribution

AFFiNE 开源前一周研究 VSCode / Vue / AppFlowy 等知名开源项目 star 分布总结的基准(口述回忆,数字加 ≈)
地区健康占比
美国≈19–21%
中国≈19–21%
欧洲(法德意英合计)≈10–15%
Top 10 常客印度、俄罗斯、巴西通常在列
  • 硬规则:开源第一周全员禁发朋友圈,内容英文优先——防止中文圈流量污染全球化分布。AFFiNE 第一周 ≈6,000 star 的分布与知名项目基准吻合(中国 ≈19%)。
  • 反例教训:第二周团队发朋友圈后,中国占比飙到 ≈35%,此后再没降下来——分布一旦被污染基本不可逆
  • 反模式:呼朋唤友第一二天刷 500-1,000 star 是舒适圈行为,会污染"全球市场试水温"的真实信号。

Benchmark summarized by researching star distributions of well-known open-source projects like VSCode / Vue / AppFlowy in the week before AFFiNE's open-sourcing (oral recall, numbers marked with ≈)
RegionHealthy Proportion
United States≈19–21%
China≈19–21%
Europe (Combined: France, Germany, Italy, UK)≈10–15%
Top 10 RegularsIndia, Russia, Brazil are usually included
  • Hard rule: No one in the team posts on Moments in the first week of open-sourcing, prioritize English content — to avoid polluting the global distribution with Chinese circle traffic. AFFiNE's ≈6,000 stars in the first week matched the benchmark of well-known projects (China ≈19%).
  • Counterexample lesson: After the team posted on Moments in the second week, China's share surged to ≈35% and never dropped since — once the distribution is polluted, it's basically irreversible.
  • Anti-pattern: Asking friends to get 500-1,000 stars in the first two days is a comfort zone behavior, which will pollute the real signal of "testing the global market temperature".

README 用户路径闭环(Star CTA Loop)

README User Path Loop (Star CTA Loop)

AFFiNE 开源实战 SOP:任何用户路径跳出去,都要能跳回来点 star。
  1. 枚举用户所有出口路径:README→官网;README→开发者文档;README→社区(Discord 等)。
  2. 每个出口页面都反向链接回 GitHub README:官网、文档站、社区页全部回链。
  3. 每个回链位置加一句 star CTA("If you like us, please give us a star on GitHub")。
  4. 闭环自检:沿每条路径走一遍,确认用户从任意出口都能一步跳回 repo 并看到 star 引导。
  5. README/官网随阶段更新:策略目标转变(如转向商业化)就即时改版,不要一成不变。

AFFiNE open-source battle-tested SOP: Any user path that jumps out must be able to jump back to click the star.
  1. Enumerate all user exit paths: README→official website; README→developer documentation; README→community (Discord, etc.).
  2. Add reverse links back to GitHub README on every exit page: Official website, documentation site, community page all link back.
  3. Add a star CTA at each backlink position ("If you like us, please give us a star on GitHub").
  4. Loop self-check: Walk through each path to confirm users can jump back to the repo in one step and see the star guide from any exit.
  5. Update README/official website with phases: Revise immediately when strategic goals change (e.g., shifting to commercialization), don't keep it unchanged.

Star 引流漏斗纪律

Star Traffic Funnel Discipline

  • 所有渠道统一回溯 GitHub link,而非官网:Reddit / Twitter / Medium / 目录站发布的链接终点都指向 repo,保证所有流量都会看到 README 里的 star 引导。
  • README 30 秒内让用户 get 价值,并直接引导点 star。
  • 首周每个渠道发不同主题的 post,不是同一篇复制粘贴。
  • 起量第一周每天看 GitHub Insights 的流量来源,据此决定接下来几天重点维护哪些渠道;"维护"= 去该渠道和潜在用户对话,不是 paid marketing。
  • 私信对标产品的 Twitter follower list:发布日定向私信 Notion / Miro 类竞品的 follower,AFFiNE 实战转化 ≈几百个 star(口述数字)。
  • 战略转移信号:star 到 ≈6,000 后不再把精力放在 GitHub 本身,转向 1v1 用户聊天 + 搭建用户社区。
  • 永远不要买 star:AFFiNE 从未买星,star 涨太快时多家投资人 DD 写爬虫验证 star 来源,完全干净——买星在尽调时必被识破。
  • 看增速不看绝对值:star 增速(而非总量)才是融资和 Trending 信号;GitHub Trending 有账号权限体系,非唯 star 论。

  • All channels link back to GitHub instead of the official website: Links posted on Reddit / Twitter / Medium / directory sites all point to the repo, ensuring all traffic sees the star guide in the README.
  • Let users get the value from README within 30 seconds, and directly guide them to click the star.
  • Post different themed content on each channel in the first week, don't copy-paste the same article.
  • Check GitHub Insights traffic sources every day in the first week of scaling, and decide which channels to focus on maintaining in the next few days; "maintenance" = talk to potential users on the channel, not paid marketing.
  • Direct message the Twitter follower list of competing products: Send targeted DMs to followers of Notion / Miro-like competitors on launch day, AFFiNE's battle-tested conversion brought ≈hundreds of stars (oral number).
  • Strategic shift signal: Stop focusing on GitHub itself after reaching ≈6,000 stars, shift to 1v1 user chats + building user communities.
  • Never buy stars: AFFiNE never bought stars. When stars grew too fast, multiple investors wrote crawlers during DD to verify star sources, which were completely clean — buying stars will definitely be detected during due diligence.
  • Look at growth rate not absolute value: Star growth rate (not total) is the signal for financing and Trending; GitHub Trending has an account permission system, it's not solely based on stars.

核心目标

Core Objectives

指标月度目标数据来源
月增 Star300+Client Project A 8个月辅导数据
内容产出8-12篇/月博客+视频+社交
KOL 触达60-80/月每天3-4个
社区活动1次线上/月31-34人参与
Contributor PR10+/月Good First Issues

MetricMonthly TargetData Source
Monthly Star Growth300+8 months of coaching data for Client Project A
Content Output8-12 pieces/monthBlog + video + social media
KOL Outreach60-80/month3-4 per day
Community Events1 online event/month31-34 participants
Contributor PRs10+/monthGood First Issues

月度执行框架(300 Star/Month Cadence)

Monthly Execution Framework (300 Star/Month Cadence)

1. 内容节奏

1. Content Rhythm

频率渠道内容类型效果基准
每周 2-3 篇Dev.to / Medium / 官方博客技术教程、用例解析、对比文章SEO 长尾流量
每周 1 个YouTube视频教程/Demo30 SGD 推流有效
每天 1-2 条Twitter/X技术向短内容、GIF、ThreadDM回复率 3-5%
每周 1 篇LinkedIn长文/案例分享DM回复率 10-15%
FrequencyChannelsContent TypeEffect Benchmark
2-3 pieces per weekDev.to / Medium / Official BlogTechnical tutorials, use case analysis, comparison articlesSEO long-tail traffic
1 per weekYouTubeVideo tutorials/Demos30 SGD promotion is effective
1-2 posts per dayTwitter/XTechnical short content, GIFs, ThreadsDM response rate 3-5%
1 piece per weekLinkedInLong articles/case sharingDM response rate 10-15%

2. 社区运营

2. Community Operations

渠道频率策略转化效率
Reddit每周 2-3 帖r/selfhosted, r/programming, r/MachineLearning帖子→Star 直接转化(AFFiNE 累计 2000+ stars)
Hacker News每月 1-2 次Content submission via agency ($500/post, ensure HN guidelines compliance — submissions must be genuine and relevant)爆发式,单帖可带 200-500 stars
Discord/Telegram每天日常互动、问题解答社区留存、口碑传播
Dev.to / Hashnode每周 1 篇跨平台分发SEO + 开发者发现
ChannelFrequencyStrategyConversion Efficiency
Reddit2-3 posts per weekr/selfhosted, r/programming, r/MachineLearningDirect conversion from post→Star (AFFiNE accumulated 2000+ stars)
Hacker News1-2 times per monthContent submission via agency ($500/post, ensure HN guidelines compliance — submissions must be genuine and relevant)Burst growth, single post can bring 200-500 stars
Discord/TelegramDailyDaily interaction, problem solvingCommunity retention, word-of-mouth spread
Dev.to / Hashnode1 piece per weekCross-platform distributionSEO + developer discovery

3. 活动驱动增长

3. Event-Driven Growth

类型频率目标人数执行要点
线上活动(Webinar/AMA)每月 1 次31-34 人技术分享 + Live Demo + Q&A
线下活动(Meetup)每季度 1 次70 人特定市场深耕(如日本)
PR Challenge每季度 1 次Hacktoberfest / Good First Issue Sprint
Hackathon 赞助按需200-500 stars/场印度学生黑客松效率最高
TypeFrequencyTarget Number of ParticipantsExecution Key Points
Online Events (Webinar/AMA)1 per month31-34Technical sharing + Live Demo + Q&A
Offline Events (Meetup)1 per quarter70Deep cultivation in specific markets (e.g., Japan)
PR Challenge1 per quarterHacktoberfest / Good First Issue Sprint
Hackathon SponsorshipOn demand200-500 stars per eventHighest efficiency in Indian student hackathons

4. Contributor 体系

4. Contributor System

阶梯设计
  1. Good First Issues — 标注清晰、低门槛、有 mentor 响应
  2. Regular Contributor — 累计 3+ PR merged → 加入 Contributors 列表
  3. Core Contributor — 负责特定模块 → Repo write access
  4. Maintainer — 代码审核权 + 社区管理权
关键动作
  • 每周标注 3-5 个 Good First Issues
  • PR 24h 内首次响应
  • 月度 Contributor Spotlight(社交媒体 highlight)
Ladder Design:
  1. Good First Issues — Clearly labeled, low threshold, with mentor responses
  2. Regular Contributor — Accumulate 3+ merged PRs → Join Contributors list
  3. Core Contributor — Responsible for specific modules → Repo write access
  4. Maintainer — Code review rights + community management rights
Key Actions:
  • Label 3-5 Good First Issues per week
  • First response to PR within 24h
  • Monthly Contributor Spotlight (social media highlight)

5. Ambassador 计划

5. Ambassador Program

角色定义:社区传播者,非代码贡献者
激励
  • 专属 badge + README 致谢
  • 早期功能体验权
  • 年度线下活动邀请
  • 推荐奖励(affiliate 模式 10-15%)
招募标准
  • 已在社交媒体自发分享过项目
  • 技术社区有一定影响力(1K+ followers)
  • 愿意每月产出 2+ 内容

Role Definition: Community communicators, non-code contributors
Incentives:
  • Exclusive badge + README acknowledgment
  • Early access to new features
  • Invitation to annual offline events
  • Referral rewards (10-15% affiliate model)
Recruitment Criteria:
  • Has spontaneously shared the project on social media
  • Has certain influence in technical communities (1K+ followers)
  • Willing to produce 2+ pieces of content per month

渠道优先级矩阵

Channel Priority Matrix

渠道适用阶段效率指标优先级
Reddit全周期帖子→Star 直接转化⭐⭐⭐
Hacker News爆发期$500/帖, 30 points⭐⭐⭐
Twitter/X全周期DM回复率 3-5%⭐⭐⭐
LinkedInB2B获客DM回复率 10-15%⭐⭐
YouTube内容沉淀30 SGD 推流有效⭐⭐
Dev.toSEO长尾文章可跨平台分发⭐⭐

ChannelApplicable PhaseEfficiency MetricPriority
RedditFull cycleDirect post→Star conversion⭐⭐⭐
Hacker NewsBurst phase$500/post, 30 points⭐⭐⭐
Twitter/XFull cycleDM response rate 3-5%⭐⭐⭐
LinkedInB2B customer acquisitionDM response rate 10-15%⭐⭐
YouTubeContent沉淀30 SGD promotion is effective⭐⭐
Dev.toSEO long-tailArticles can be distributed cross-platform⭐⭐

预算分配(月度 $2K-5K 档)

Budget Allocation (Monthly $2K-5K Tier)

项目预算预期产出
HN Agency$500-10001-2 帖, 各 30+ points
YouTube 推流$100-300视频曝光 + 网站点击
KOL 合作$500-20005-10 个中腰部 KOL
活动费用$200-5001次线上 + 物料
工具订阅$100-200Phantombuster、分析工具
Note: Automated outreach must comply with platform rate limits and anti-spam policies. Always respect opt-out requests.

ItemBudgetExpected Output
HN Agency$500-10001-2 posts, 30+ points each
YouTube Promotion$100-300Video exposure + website clicks
KOL Collaboration$500-20005-10 mid-tier KOLs
Event Costs$200-5001 online event + materials
Tool Subscriptions$100-200Phantombuster, analytics tools
Note: Automated outreach must comply with platform rate limits and anti-spam policies. Always respect opt-out requests.

数据漏斗

Data Funnel

曝光(Impression)
  → 访问 GitHub Repo(CTR 2-5%)
    → Star(访问→Star 转化率 10-30%)
      → Clone/Fork(Star 的 5-10%)
        → Contributor(Fork 的 1-5%)
          → 付费用户/Enterprise Lead

Impression
  → GitHub Repo Visit (CTR 2-5%)
    → Star (Visit→Star conversion rate 10-30%)
      → Clone/Fork (5-10% of Stars)
        → Contributor (1-5% of Forks)
          → Paid User/Enterprise Lead

实战 Benchmark(数据来源)

Battle-Tested Benchmarks (Data Sources)

项目成果时间线关键策略
AFFiNE10K stars in 43 days, 60K+ total2023-2026Reddit(2000+ stars) + HN + KOL + Contributor体系
Client Project A0→10K stars8 个月月度300 SOP + HN Agency + YouTube
ProjectOutcomeTimelineKey Strategies
AFFiNE10K stars in 43 days, 60K+ total2023-2026Reddit(2000+ stars) + HN + KOL + Contributor system
Client Project A0→10K stars8 monthsMonthly 300 SOP + HN Agency + YouTube

AFFiNE Star 时间轴(一手口径)

AFFiNE Star Timeline (Firsthand Source)

节点数据
开源日2022-08-03
72 小时≈1,000 star
第一周≈6,000 star(80% 来自海外)
43 天破 10,000 star
2022-08 至 2022-12≈28 次登上 GitHub Trending(开源第 5 天登顶)
24 个月60,000+ star
  • Reddit 实证:r/selfhosted、PKM 等子版块带来几万流量,累计转化至少 2,000 star(≈10 帖火 3-4 帖,其余没火或被 remove)。
  • 可信度背书:全程零 paid marketing、从未买星,多家投资人 DD 时写爬虫验证 star 来源,完全干净。
  • 预期管理(self-reported):复制该 SOP 不保证"一周 6,000 star",但 3 个月做到 1,000–3,000 star 相对容易,已有其他团队按 SOP 复现。

MilestoneData
Open-Source Date2022-08-03
72 Hours≈1,000 stars
First Week≈6,000 stars (80% from overseas)
43 DaysExceeded 10,000 stars
2022-08 to 2022-12≈28 times on GitHub Trending (topped the list on the 5th day of open-sourcing)
24 Months60,000+ stars
  • Reddit Evidence: Subreddits like r/selfhosted, PKM brought tens of thousands of traffic, accumulating at least 2,000 stars (≈3-4 out of 10 posts went viral, others didn't or were removed).
  • Credibility Endorsement: Zero paid marketing, never bought stars. Multiple investors wrote crawlers during DD to verify star sources, which were completely clean.
  • Expectation Management (self-reported): Copying this SOP doesn't guarantee "6,000 stars in one week", but reaching 1,000–3,000 stars in 3 months is relatively easy, and other teams have already replicated it successfully.

完整 SOP 参考

Full SOP Reference

详见 references/full-sop.md — 包含日/周/月完整执行清单、模板、工具链推荐。
See references/full-sop.md — Includes complete daily/weekly/monthly execution checklists, templates, and toolchain recommendations.