Contribute to Shahada.org
Help make the world's simplest guide to embracing Islam better for everyone. We welcome volunteers — developers, translators, and anyone who cares about clarity and accuracy.
Ways to help
- Fix or suggest translations — If you speak one of our 40+ languages and see an error, report it or submit a pull request.
- Report bugs — Something broken on your device or browser? Open a bug report.
- Suggest improvements — Have an idea for content or UX? Open a feature request.
- Improve accessibility — Help us reach people with disabilities. Check our Contributing guide and open an issue or PR.
Where to start
We use GitHub for all tasks. You don't need to be a developer to contribute — many tasks are translations or small edits.
- Good first issues — Small, well-defined tasks for new contributors.
- Help wanted — Tasks where we'd love community help.
- All open issues — Bugs, features, and ideas.
- Open pull requests — See what others are working on.
Spread the Word
The most impactful thing you can do is help more people find Shahada.org. Every link, share, and mention makes a difference.
Link from your website
If you run a mosque website, Islamic blog, or community page, please link to us. You can copy this HTML:
<a href="https://shahada.org">Shahada.org — Free guide to becoming Muslim</a>
Share on social media
Share Shahada.org on your social media accounts. A simple post can reach someone at the right moment:
"Shahada.org is a free, simple guide to embracing Islam — available in 40+ languages. Share it with anyone who might be interested. https://shahada.org"
Tell your local mosque
Ask your imam or community leader to mention Shahada.org as a resource for people interested in Islam. Many mosques have websites or newsletters — a simple link helps us reach more people.
Add to Islamic resource directories
If you know of Islamic resource lists, directories, or link collections, please suggest adding Shahada.org. We are a free, non-profit, open-source project focused solely on helping people take their first step into Islam.
Before you contribute
Please read our Contributing guide and Code of Conduct. We keep the project simple (plain HTML, CSS, JS) so anyone can contribute.
Questions?
Open a GitHub issue and ask. We'll get back to you as soon as we can.