LaunchRepoKort antwoord
- Begin bij de repository zelf: een README die zegt wat het is, waarom en hoe je begint, een licentie, tot 20 GitHub-topics en een social preview-afbeelding.
- Ga daarna naar de plekken waar je gebruikers al praten: het forum, de chat of de subreddit van je taal of framework, en Show HN zodra mensen het zonder account kunnen draaien.
- Vraag de maintainers van een of twee passende awesome lists om opname, volgens de eigen bijdrageregels van elke lijst.
- Zet een website of gehoste versie op een paar directory’s en launchplatforms, en blijf releases uitbrengen. Gestage activiteit blijft nieuwe bezoekers brengen.
De distributiekaart voor open source
Open source kent vier lagen van ontdekking. Elke laag bouwt voort op de vorige: een communitypost stuurt mensen naar je repository, dus de repository moet ze eerst overtuigen.
- 1 · De repositoryWat elke bezoeker als eerste ziet.
- README
- Licentie
- Topics
- Social preview
- Releases
- 2 · Ontdekking op GitHubHoe mensen je binnen GitHub vinden.
- Topicpagina’s
- GitHub-zoekfunctie
- Explore
- Sterren en lijsten
- 3 · Community’sWaar je gebruikers al praten.
- Show HN
- Forums en chats van je ecosysteem
- Subreddits
- Antwoorden op Q&A-sites
- 4 · Gecureerd en vermeldPlekken die naar je blijven verwijzen.
- Awesome lists
- Package registries
- Directory’s
- Nieuwsbrieven
Stel je vierwekenplan samen
Beantwoord acht vragen en plak je topics. De planner toetst de topics aan de regels van GitHub en zet elk kanaal in een week, gemarkeerd als klaar of met wat je eerst moet oplossen. Alles draait in je browser; er wordt niets verstuurd of opgeslagen.
Maak de repository vindbaar
Elk kanaal op deze pagina eindigt op de pagina van je repository. De documentatie van GitHub noemt de vragen die een README moet beantwoorden; de tabel vertaalt dat naar concrete inhoud voor het eerste scherm.
| Onderdeel | Wat de bezoeker nodig heeft | Wat werkt |
|---|---|---|
| Wat het doet | Binnen seconden beslissen of het bij hun probleem past | Eén zin onder de titel, in de woorden waarop je gebruikers zouden zoeken |
| Waarom het nuttig is | Een reden om het te kiezen boven het voor de hand liggende alternatief | Eén concreet verschil, of een korte vergelijking |
| Hoe je begint | Een eerste succes binnen minuten | Eén installatiecommando en één minimaal voorbeeld dat werkt zoals het geplakt wordt |
| Laat het werken zien | Bewijs voordat ze installeren | Een screenshot, GIF of terminalopname bovenaan |
| Waar je hulp krijgt | Vertrouwen dat ze er niet alleen voor staan | Link naar Issues, Discussions of een chat; zeg wat waar hoort |
| Wie het onderhoudt | Vertrouwen dat het project leeft | Maintainers, recente release, bijdragegids |
Topics: tot 20 ingangen naar de zoekfunctie van GitHub
- Combineer de vier soorten die GitHub voorstelt: doel (cli, static-site-generator), onderwerp (accessibility), community (hacktoberfest) en taal (rust).
- Gebruik de topics waar mensen echt door bladeren. Open github.com/topics/ en controleer of een topic al repositories bevat.
- GitHub stelt ook zelf topics voor bij openbare repositories. Accepteer de passende en wijs de rest af.
Social preview
Zonder afbeelding toont een gedeelde link alleen basisgegevens van de repository en je avatar. Een heldere afbeelding van 1280 × 640 met de projectnaam en één regel over het doel maakt elke share herkenbaar. Controleer formaat en bestandstype in de gratis afbeeldingsformaatchecker voordat je uploadt. Check je launchafbeeldingen tegen de formaateisen van platforms →
| Regel | Officiële tekst | Wat het voor jou betekent |
|---|---|---|
| README | A README is often the first item a visitor will see when visiting your repository. | Behandel de README als je landingspagina: het bovenste scherm bepaalt of mensen blijven. |
| Lengte van de README | When your README is viewed on GitHub, any content beyond 500 KiB will be truncated. | Lange README’s worden afgekapt. Verplaats uitgebreid naslagmateriaal naar de documentatie en link ernaar. |
| Soorten topics | Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language. | Kies topics verspreid over doel, onderwerp, community en taal, niet tien varianten van één woord. |
| Topicformaat | Use lowercase letters, numbers, and hyphens. Use 50 characters or less. Add no more than 20 topics. | De checker in de planner past precies deze drie regels toe. |
| Social preview | Your image should be a PNG, JPG, or GIF file under 1 MB in size. For the best quality rendering, we recommend a size of at least 640 by 320 pixels (1280 by 640 pixels for best display). | Maak een PNG of JPG van 1280 × 640 onder 1 MB. |
| Communityprofiel | The community profile checklist checks to see if a project includes recommended community health files, such as README, CODE_OF_CONDUCT, LICENSE, or CONTRIBUTING, in a supported location. | Open Insights → Community Standards in je repository en vul aan wat ontbreekt. |
Awesome lists: twee verschillende routes
Awesome lists zijn gecureerde verzamelingen op GitHub, één per onderwerp. De vaak geciteerde regels, zoals 30 dagen en vier reviews, gelden voor één specifiek geval. Weet welke route jij volgt.
Route A: je project komt in een themalijst
Dit is het gewone geval voor een library, tool of app. Zoek een of twee actieve lijsten voor je onderwerp, lees het bijdragebestand van die lijst en stel één regel voor in het formaat van die lijst. Lijsten verschillen in wat ze accepteren, dus hun eigen gids is de regel. Je README, licentie en recente activiteit overtuigen de maintainer.
Route B: je gecureerde lijst komt in de awesome-metalijst
Alleen als je zelf een lijst onderhoudt. Dan geldt het strenge template van de metalijst: minstens 30 dagen oud, 4 andere openstaande pull requests reviewen, awesome-lint draaien, een Creative Commons-licentie, de topics awesome en awesome-list en een titel in de vorm “Add Name of List”.
| Regel | Officiële tekst | Wat het voor jou betekent |
|---|---|---|
| Toevoegen aan een lijst | If you have something awesome to contribute to an awesome list, this is how you do it. | Elke lijst legt zijn eigen route uit. Lees de bijdragegids van die lijst, niet een algemene. |
| Leeftijd van de lijst | That means 30 days from either the first real commit or when it was open-sourced. Whatever is most recent. | Alleen voor lijsten die in de awesome-metalijst willen: wacht 30 dagen na de eerste echte commit. |
| Reviews | Just commenting “looks good” or simply marking the pull request as approved does not count! | Wie iets voor de metalijst indient, reviewt minstens 4 andere openstaande pull requests, met echte feedback. |
| AI | Fully AI-generated pull requests are not accepted. | Schrijf de pull request zelf. Een volledig gegenereerde wordt gesloten. |
| Licentie | A code license like MIT, BSD, Apache, GPL, etc, is not acceptable. | Een lijst heeft een Creative Commons-licentie nodig, bij voorkeur CC0. Codelicenties tellen niet. |
| Kwaliteit | Only has awesome items. Awesome lists are curations of the best, not everything. | Lijsten nemen het beste op, niet alles. Je README en activiteit bepalen of je erin komt. |
We citeren de regels zoals ze op de controledatum luidden; maintainers passen ze aan. LaunchRepo opent geen pull requests en neemt geen contact op met maintainers van lijsten namens jou.
Community’s die projecten verwelkomen
Open source heeft hier een voordeel: veel ontwikkelaarscommunity’s zien graag een werkend project, zolang het een echt probleem oplost en jij blijft om vragen te beantwoorden.
| Kanaal | Past het best bij | Eerste stap |
|---|---|---|
| Show HN (Hacker News) | Tools die mensen meteen kunnen draaien | Post één keer, blijf in de thread, beantwoord elke vraag |
| Het forum of de chat van je ecosysteem | Libraries en plug-ins voor één taal of framework | Lees de regels voor projectpresentaties en post dan een use case, geen slogan |
| Een passende subreddit | Projecten met een duidelijk publiek op Reddit | Controleer eerst de zelfpromotieregel van elke subreddit |
| Antwoorden op Q&A-sites | Projecten die een terugkerende vraag oplossen | Beantwoord de vraag volledig; noem het project waar het echt helpt |
| Wekelijkse nieuwsbrieven van je ecosysteem | Releases met een verhaal | Stuur de redactie een korte notitie met de link naar de release |
| Meetups en conferentietalks | Projecten met een les om te delen | Begin bij een lokale meetup van je taal |
In onze openbare dataset van alle 15.859 Show HN-posts die tussen september 2025 en augustus 2026 naar een coderepository linkten, kreeg de mediane post 2 punten en haalde 9,5% 10 punten of meer. Eén post is een begin, niet het plan.
Zo lanceer je je project op Show HN →Promoot je SaaS op Reddit zonder de regels te breken →
| Regel | Officiële tekst | Wat het voor jou betekent |
|---|---|---|
| Wat past | Show HN is for something you've made that other people can play with. | Iets wat mensen kunnen draaien, geen aankondiging of landingspagina. |
| Inhoud | The project should be non-trivial. Don't post quickly-generated one-offs; anybody can do that now. | Post een project waar je echt werk in hebt gestoken en waarover je kunt praten. |
| Drempels | Please make it easy for users to try your thing out, ideally without barriers such as signups or emails. | Een openbare repository met één installatiecommando is de ideale Show HN. |
| Stemmen | Please don't ask friends to upvote or comment. That's not ok on HN. | Deel de link zonder om stemmen te vragen. Laat het werk spreken. |
| Doelgroep | Don’t spam as many people as possible. Instead, target your efforts to communities that will benefit from knowing about your project. | Kies een paar community’s waar het project een echt probleem oplost. |
| Reputatie | the best way to invite people to share and contribute to your project is to share and contribute to their projects. | Help eerst in andere projecten. Mensen merken dat en kijken naar het jouwe. |
Directory’s en launchplatforms
Zodra er een website, documentatiesite of gehoste versie is, worden een paar directory’s een vaste extra bron van bezoekers en links. Drie die goed bij open source passen:
- AlternativeTo: als je project een gratis alternatief is voor bekende software.
- SourceForge: host open source projecten met downloads via de route Create a Project, los van de vermeldingen voor zakelijke software.
- Product Hunt: voor projecten met een verzorgde interface en een launchdag waarbij je zelf aanwezig kunt zijn.
Kies platforms op basis van hun publiek en controleer de actuele regels van elk platform; een vermelding is een deur, geen garantie op gebruikers. Zet je developertool op de plekken waar developers echt zoeken. →
Wat je beter laat
- Gekochte of geruilde sterren
- Het beleid van GitHub verbiedt het manipuleren van rankings, en onderzoek laat zien dat gekochte sterren maar kort helpen. De details, met onze eigen meting: GitHub-sterren verdienen door echt nuttig te zijn →
- Vrienden vragen om te upvoten
- Hacker News zegt het duidelijk: dat is niet oké. Stemmen van een vriendengroep vertellen je bovendien niets over echte interesse.
- Overal dezelfde post
- Gekopieerde aankondigingen in veel community’s op één dag komen over als spam. Kies een paar plekken en schrijf voor elke plek apart.
- Een launch vóór de README
- Aandacht is kort. Zorg dat het eerste scherm van de repository klopt voordat er ook maar één post uitgaat.
Waar LaunchRepo past
LaunchRepo neemt de laag van directory’s en launchplatforms voor zijn rekening: je coding agent bereidt je projectwebsite voor en dient die in bij een grote catalogus van directory’s, met een tracker die een live vermelding onderscheidt van een vermelding die nog in behandeling is.
Communityposts, verzoeken aan awesome lists en gesprekken blijven bij jou, omdat ze het best werken in je eigen stem. LaunchRepo maakt de uren vrij die de formulieren zouden kosten, zodat je ze daar kunt besteden.
Bronnen
Alle regels zijn gelezen op 1 oktober 2026 en worden woordelijk in het Engels geciteerd. Tekstkopieën bewaren we bij ons bewijsmateriaal.
| Bron | Laatst bijgewerkt | Gecontroleerd |
|---|---|---|
| GitHub Docs: About the repository README file | geen datum vermeld | |
| GitHub Docs: Classifying your repository with topics | geen datum vermeld | |
| GitHub Docs: Customizing your repository's social media preview | geen datum vermeld | |
| GitHub Docs: About community profiles for public repositories | geen datum vermeld | |
| GitHub Docs: Accessing a project's community profile | geen datum vermeld | |
| GitHub Docs: Saving repositories with stars | geen datum vermeld | |
| sindresorhus/awesome: pull request template | geen datum vermeld | |
| sindresorhus/awesome: contribution guidelines | geen datum vermeld | |
| Hacker News: Show HN Guidelines | geen datum vermeld | |
| Open Source Guides: Finding Users for Your Project | geen datum vermeld | |
| GitHub Acceptable Use Policies | geen datum vermeld | |
| He et al.: Six Million (Suspected) Fake Stars in GitHub (ICSE 2026, arXiv:2412.13459v2) |
Veelgestelde vragen
- Hoe promoot ik een open source project?
- Begin bij de repository: een README die zegt wat het is, waarom en hoe je begint, een licentie, topics en een preview-afbeelding. Deel het daarna in de community van je ecosysteem en op Show HN zodra mensen het zonder account kunnen proberen, vraag opname in een of twee passende awesome lists en blijf releases uitbrengen.
- Hoe krijg ik mijn project in een awesome list?
- Open de lijst, lees het bijdragebestand en stel één item voor in het formaat van de lijst. De strenge regels (30 dagen, vier reviews, awesome-lint) gelden alleen als je je eigen gecureerde lijst bij de awesome-metalijst indient.
- Hoeveel GitHub-topics moet ik toevoegen?
- GitHub staat er tot 20 toe. Gebruik de topics die doel, onderwerp, community en taal beschrijven, geschreven in kleine letters, cijfers en koppeltekens, elk 50 tekens of minder.
- Is Show HN een goede plek voor open source?
- Ja, als mensen het project meteen kunnen draaien en jij kunt blijven om vragen te beantwoorden. Show HN vraagt om iets wat mensen kunnen uitproberen, zonder registratiedrempels, en zonder vrienden om stemmen te vragen.
- Moet ik GitHub-sterren kopen om gevestigd over te komen?
- Nee. De Acceptable Use Policies van GitHub verbieden het manipuleren van rankings, zoals geautomatiseerd sterren geven, en een groot onderzoek ontdekte dat gekochte sterren maar kort helpen en op de lange termijn schaden.
- Post LaunchRepo voor mij in community’s?
- Nee. LaunchRepo geeft je agent de playbooks voor inzendingen bij directory’s en launchplatforms voor de website van je project. Communityposts en verzoeken aan awesome lists blijven persoonlijk.
Laat je agent de directory’s doen
Eén aankoop, je coding agent, elk product dat je bouwt: je coding agent dient met LaunchRepo je projectwebsite in bij directory’s en launchplatforms terwijl jij met je gebruikers praat.
Bekijk de prijzen