How I Got 33K GitHub Stars: The Complete Marketing Playbook
TL;DR: Getting 33,000 stars on GitHub isn't luck—it's a systematic approach combining great product, strategic launch timing, community building, and relentless execution. Here's exactly how we did it with AFFiNE.
The Journey: From 0 to 33K Stars
In August 2022, we launched AFFiNE—an open-source Notion + Miro alternative. Within 7 days, we hit 6,000 stars. 18 months later, we crossed 33,000.
This wasn't an accident. Here's the playbook.
Phase 1: Pre-Launch Preparation (2-4 Weeks Before)
1. Product Positioning
Before anything else, nail your one-liner:
"AFFiNE: The Open Source Alternative to Notion + Miro"
Your positioning should:
- Reference a known category (Notion, Miro)
- Differentiate clearly (open source, privacy-first)
- Be instantly understandable (no jargon)
2. README Optimization
Your README is your landing page. Include:
- Compelling hero image/GIF
- Clear value proposition (first 3 lines)
- Quick start (under 5 minutes)
- Feature highlights with visuals
- Contribution guidelines
- Social proof (if any)
3. Build Your Launch List
We spent 3 weeks building a list of:
- 50+ tech Twitter KOLs
- 20+ relevant subreddits
- 10+ Discord/Slack communities
- 5+ newsletter editors
Tools we used:
- Phantombuster (Twitter scraping)
- Spreadsheet tracking every contact
- Twitter Lists for monitoring
Phase 2: Launch Day Execution
The First 24 Hours Matter Most
08:00 UTC - Post to GitHub (optimize for different timezones)
09:00 UTC - Twitter announcement thread:
🚀 Introducing AFFiNE - The Open Source Alternative to Notion + Miro
After months of building, we're finally live!
Here's why we built it 🧵
10:00 UTC - Reddit posts (stagger by 30 min):
- r/selfhosted
- r/opensource
- r/degoogle
- r/programming
11:00 UTC - Hacker News submission
12:00 UTC - Personal outreach to KOLs begins
Key Insight: Don't Spam, Provide Value
Every post should answer: "Why should THIS community care?"
For r/selfhosted: Focus on self-hosting, privacy
For r/programming: Focus on tech stack, architecture
For r/opensource: Focus on contribution opportunities
Phase 3: Momentum Building (Week 1-4)
Product Hunt Launch
We launched on Product Hunt 2 weeks after GitHub, using the initial traction as social proof.
Result: #1 Product of the Day, 30x daily winner overall
Tips:
- Launch on Tuesday-Thursday (highest engagement)
- Respond to EVERY comment
- Prepare a "launch squad" to upvote early
- Create a compelling video demo
Keep the Conversation Going
- Daily engagement on Twitter
- Weekly changelog posts
- Monthly "State of AFFiNE" updates
- Respond to every GitHub issue within 24h
Phase 4: Long-Term Growth
Community Building > Marketing
Our Discord grew to 10,000+ members because we:
- Created genuine value (tutorials, templates)
- Celebrated contributors publicly
- Hosted community calls
- Made users feel heard
Content That Compounds
We published:
- Dev blogs on our tech decisions
- Comparison guides (AFFiNE vs Notion)
- Tutorial videos
- Case studies from real users
GitHub Trending = Growth Loops
Every time we hit GitHub Trending:
- New users discover us
- Some become contributors
- Contributors create content
- Content drives more discovery
The Numbers That Matter
| Metric | Result |
|---|---|
| Day 1 Stars | 2,000 |
| Week 1 Stars | 6,000 |
| Month 1 Stars | 15,000 |
| Month 18 Stars | 33,000 |
| Discord Members | 10,000+ |
| Contributors | 200+ |
| Countries Reached | 150+ |
Key Lessons Learned
1. "Marketing" Starts at Product
No amount of promotion saves a bad product. We spent 6 months in stealth before launching.
2. Timing Matters
We launched when Notion raised prices and added AI—perfect timing for an "open source alternative" narrative.
3. Community > Campaigns
One genuine community member creates more value than 100 one-time visitors.
4. Consistency Beats Virality
We showed up every single day for 18 months. That compounds.
5. Open Source is a Superpower
Transparency builds trust. Our users became our evangelists.
Your Action Items
- This week: Nail your positioning (one-liner test)
- Next week: Optimize your README
- Week 3: Build your launch list (50+ contacts)
- Week 4: Execute your launch
Want the Complete Playbook?
I've compiled everything I learned into the Open-Source Project Integrated Marketing Action Manual — including:
- Detailed launch checklists
- KOL outreach templates
- Reddit post frameworks
- Product Hunt optimization guides
- Budget allocation strategies
It covers the full journey from 0 to scale.
About Me
I'm Iris (生姜iris), former cofounder & COO of AFFiNE. I led our global go-to-market from 0 to millions of users and $10M+ raised.
Now I help founders and developers launch their products globally through consulting and these playbooks.
- 🐦 Twitter: @Gingiris_
- 💬 Telegram: @Iris_carrot
- 📚 GitHub Playbooks: Gingiris
What's your biggest challenge with open source marketing? Drop a comment below—I read and reply to all of them.
Top comments (0)