promote-open-source-project

<p align="center"> <img alt="oss image" src="./imgs/zoss-logo.svg" height="200px" width="200px"> </p> <p align="center"> <a href="https://twitter.com/intent/tweet?text=How%20to%20promote%20your%20open-source%20projects%20@ZenikaOSS&url=https://github.com/zenika-open-source/open-source-promotion-cheat-sheet&hashtags=OpenSource,CheatSheet"> <img alt="tweet" src="https://img.shields.io/twitter/url/https/twitter?label=Share%20on%20twitter&style=social" target="_blank" /> </a> </p> <h1 align="center">Open source promotion cheat sheet</h1>

This cheat sheet summarizes important steps you should follow to promote your open source project in the best conditions. You can click items to expand and get more information from a topic.

List of available languages:

• ‎العربية
• English
• Català
• Deutsch
• Español
• پارسی
• Français
• Bahasa Indonesia
• Italiano
• 日本語
• Português
• Русский
• සිංහල
• Türkçe
• 简体中文
• 繁體中文

A language is missing? Want to improve this cheat sheet? Contributions are welcome!

A PDF version of this cheat sheet is available here.

1. 🎢 Preparation step

<br /> <details> <summary>👌 Make sure that your project is mature enough</summary> <p>

Your project must be stable enough with the minimum viable features in order to hook users.

</p> </details> <details> <summary>😎 Choose a cool name for your cool project</summary> <p>

Choose a name that users can easily remember.

</p> </details> <details> <summary>💅 Make your README pretty</summary> <p>

The README is the first thing your visitors will see. Make it simple, pretty and easy to read. Here is a list of beautiful READMEs.

</p> </details> <details> <summary>💪 Highlight the strong points of your project</summary> <p>

Identify your project's strengths and make sure visitors see them first.

</p> </details> <details> <summary>✨ Provide a demo of your project</summary> <p>

Visitors will want to quickly understand the purpose of your project, how it works, and how to use it. Providing a demo is the best way to satisfy users. It could be:

• An animated GIF demonstrating how your project works
• A link to a live demo

</p> </details> <details> <summary>👌 Install/Usage must be super easy</summary> <p>

You'll probably lose visitors if your project is not user-friendly.

</p> </details> <details> <summary>📘 Create a clean and well structured documentation</summary> <p>

Creating a good documentation is probably the most important step. If you have a small documentation, you can include it within your README. Otherwise, you should probably host it in a separate website. Some open source projects like vuepress can help you with creating a clean documentation in a simple way.

</p> </details> <br />

2. 📢 Spread the word about your hard works

<br /> <details> <summary>⭐ Make your project trustable before publishing it on social networks</summary> <p>

Most visitors will check how many stars the project has before considering using it. A minimum amount of stars makes your project more trustable than a project with zero star. This is why you should ask people you know to support your project before doing a public announcement on social media.

</p> </details> <details> <summary>↗️ Share your project on social media and specialized platforms</summary> <p>

Tell the World about your awesome work! Publish it on social media and other specialized platforms:

• Twitter
• Linkedin
• Facebook
• Reddit
• Dev.to
• Lobsters
• Hacker News
• Product Hunt
• Beta page
• Human Coders

</p> </details> <details> <summary>📃 Write articles that mention your project</summary> <p>

Write articles about your project. Purpose can be the technical stack you used, how your project works, problems you encountered, etc. Post it to publishing platforms:

• medium
• dev.to

</p> </details> <details> <summary>🎤 Present your project at conferences/meetups</summary> <p>

Presenting your project at conferences or meetups is a good way to improve its visibility.

</p> </details> <details> <summary>🎥 Record and publish videos presenting your project, how it works, etc</summary> <p>

Recording a video is not an easy exercise. However, it's probably the most efficient way to make your project famous.

</p> </details> <details> <summary>🕐 Choose the best time to publish on social media</summary> <p>

Don't publish during holiday periods or weekends. The best time to publish on social networks is usually mid-week.

</p> </details> <details> <summary>🗑 Don't spam platforms with your promotion</summary> <p>

Don't publish twice on the same platform. It will be considered as spam and it might cause bad publicity for your project.

</p> </details> <br />

3. 🤝 Keep your users

<br /> <details> <summary>🆕 Try to regularly release new versions of your project</summary> <p>

Maintain and improve your project with new releases and generate changelogs.

</p> </details> <details> <summary>❗ Maintain your project, process opened issues</summary> <p>

Do not let issues stay open without a single response. Be nice with people that took the time to open issues. 😉

</p> </details> <details> <summary>🙏 Invite users to contribute</summary> <p>

A healthy project is a project with a community and contributors. Let your users know that you need help by tagging some issues with contribution welcome or good first issue labels. See github labels.

</p> </details> <details> <summary>🏆 Reward contributors</summary> <p>

Be nice with people that helped you! Some open source projects like gatsby reward contributors with goodies. If you can't afford that, do a public post (on twitter or other platforms) about the contribution and mention the author (here is an example of public thanks). Open a Contributors section in your README to publicly thank them or showcase them on your project documentation or website. Here are some examples:

• vuepress (contributors README section)
• Rythm.js (random highlighted contributor on demo page)

</p> </details> <details> <summary>💬 Open a community chat platform</summary> <p>

Github issues are not always the best way to communicate with your users. If necessary, you can use chat platforms to discuss with them:

• Discord
• Slack
• Gitter

</p> </details> <details> <summary>🔙 Ask for feedback</summary> <p>

User feedback is the best way to improve your project. They probably have features and ideas that could make your project better.

</p> </details> <details> <summary>❤️ Open a use case gallery to show what users built with your project</summary> <p>

Visitors will trust your project if they see concrete use cases and success stories, e.g., the vuepress gallery.

</p> </details> <br />

🙏 Show your support

⭐️ this repository if this cheat sheet helped you!

<br />

❤️ Contributors

Thanks go to these wonderful people:

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://www.franck-abgrall.me/"><img src="https://avatars3.githubusercontent.com/u/9840435?v=4?s=100" width="100px;" alt=""/><br />_{<b>Franck Abgrall</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=kefranabg" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/tbetous"><img src="https://avatars3.githubusercontent.com/u/4435536?v=4?s=100" width="100px;" alt=""/><br />_{<b>Thomas Betous</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=tbetous" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/ebriand"><img src="https://avatars1.githubusercontent.com/u/1011902?v=4?s=100" width="100px;" alt=""/><br />_{<b>Eric Briand</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=ebriand" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/FaustineG"><img src="https://avatars.githubusercontent.com/u/27639429?v=4?s=100" width="100px;" alt=""/><br />_{<b>Faustine Godbillot</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=FaustineG" title="Documentation">📖</a></td> <td align="center"><a href="https://myvirtualstorybook.com/"><img src="https://avatars1.githubusercontent.com/u/5747538?v=4?s=100" width="100px;" alt=""/><br />_{<b>Benjamin Plouzennec</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=Okazari" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/Zenigata"><img src="https://avatars1.githubusercontent.com/u/1022393?v=4?s=100" width="100px;" alt=""/><br />_{<b>Johan Bonneau</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=Zenigata" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/bpetetot"><img src="https://avatars3.githubusercontent.com/u/516360?v=4?s=100" width="100px;" alt=""/><br />_{<b>Benjamin Petetot</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=bpetetot" title="Documentation">📖</a></td> </tr> <tr> <td align="center"><a href="https://nick-hat-boecker.de"><img src="https://avatars0.githubusercontent.com/u/8366071?v=4?s=100" width="100px;" alt=""/><br />_{<b>NickHatBoecker</b>}</a><br /><a href="#translation-NickHatBoecker" title="Translation">🌍</a></td> <td align="center"><a href="https://github.com/Claire"><img src="https://avatars2.githubusercontent.com/u/5114096?v=4?s=100" width="100px;" alt=""/><br />_{<b>Claire Martinez</b>}</a><br /><a href="#translation-claire" title="Translation">🌍</a></td> <td align="center"><a href="https://hazeforum.com/"><img src="https://avatars2.githubusercontent.com/u/31011359?v=4?s=100" width="100px;" alt=""/><br />_{<b>André Gama</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=andregamma" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/mbernardeau"><img src="https://avatars0.githubusercontent.com/u/7049049?v=4?s=100" width="100px;" alt=""/><br />_{<b>Mathias Bernardeau</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=mbernardeau" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/Antoineoili"><img src="https://avatars1.githubusercontent.com/u/50737365?v=4?s=100" width="100px;" alt=""/><br />_{<b>Antoine Oili</b>}</a><br /><a href="https://github.com/zenika-open-source/promote-open-source-project/commits?author=Antoineoili" title="Documentation">📖</a></td> <td align="center"><a href="https://twitter.com/dev_oswld"><img src="https://avatars1.githubusercontent.com/u/40254158?v=4?s=100" width="100px;" alt=""/><br />_{<b>Oswld TC</b>}</a><br /><a href="#translation-dev-oswld" title="Translation">🌍</a></td> <td align="center"><a href="https://yizhiyue.me"><img src="https://avatars3.githubusercontent.com/u/8545277?v=4?s=100" width="100px;" alt=""/><br />_{<b>Zhiyue Yi</b>}</a><br /><a href="#translation-ZhiyueYi" title="Translation">🌍</a></td> </tr> <tr> <td align="center"><a href="https://github.com/aliruss"><img src="https://avatars3.githubusercontent.com/u/32896351?v=4?s=100" width="100px;" alt=""/><br />_{<b>Ali khalili</b>}</a><br /><a href="#translation-aliruss" title="Translation">🌍</a></td> <td align="center"><a href="https://pakseresht.eu/"><img src="https://avatars3.githubusercontent.com/u/9018054?v=4?s=100" width="100px;" alt=""/><br />_{<b>Niusha Pakseresht</b>}</a><br /><a href="#translation-niusha-paks" title="Translation">🌍</a></td> <td align="center"><a href="https://github.com/david-dasilva"><img src="https://avatars1.githubusercontent.com/u/372391?v=4?s=100" width="100px;" alt=""/><br />_{<b>David Da Silva</b>}</a><br /><a href="#translation-david-dasilva" title="Translation">🌍</a></td> <td align="center"><a href="http://umuts.info"><img src="https://avatars2.githubusercontent.com/u/3245166?v=4?s=100" width="100px;" alt=""/><br />_{<b>Umut Işık</b>}</a><br /><a href="#translation-umutphp" title="Translation">🌍</a></td> <td align="center"><a href="https://github.com/alextremp"><img src="https://avatars0.githubusercontent.com/u/20399660?v=4?s=100" width="100px;" alt=""/><br />_{<b>Alex Castells</b>}</a><br /><a href="#translation-alextremp" title="Translation">🌍</a></td> <td align="center"><a