Skip to main content

CONTRIBUTING

Welcome to the Thunderbird for Android project! We're excited to have you here and welcome your contributions.

🌱 New Contributor Essentials​

Before you start contributing, please take a moment to familiarize yourself with the following:

Note: Some support resources currently point to the K-9 Mail forum due to the project’s history and ongoing migration. Where appropriate, we’ll update links to Thunderbird-specific channels.

Helpful background (not strictly required):

πŸ› Bug Reports and Feature Ideas​

When you encounter a bug or have a feature request or idea, please do the following:

Bugs:

Feature Requests / Ideas:

We don’t track new ideas or feature requests in GitHub Issues.

  • Start a discussion in Mozilla Connect – Ideas
  • Once a feature is accepted and work is planned, maintainers will create the corresponding GitHub issue(s).

GitHub Work:

GitHub Bug Issues track confirmed defects. GitHub Feature Issues and GitHub Task Issues track work that maintainers have accepted and planned. New feature proposals still start in Mozilla Connect; maintainers create GitHub issues after a proposal is accepted and scheduled.

  • External contributors should start from an existing GitHub Bug Issue, GitHub Feature Issue, or GitHub Task Issue.
  • Bug issues labeled unconfirmed are not ready for contributions.
  • Issues labeled tb-team are reserved for maintainers.
  • If you are unsure whether an existing issue is ready for your contribution, follow Working From GitHub Issues.

🌐 Translations​

If you'd like to help to translate Thunderbird for Android, please visit:

🀝 Contributing Code​

This should give you a detailed overview on how to contribute code to the project. Use it as a reference for setup, development, testing, and review.

πŸš€ Getting Started​

πŸ—οΈ Development Practices​

  • Engineering – Process and artifacts for proposing, deciding, and delivering technical changes (RFCs, Technical Designs, ADRs).
  • Architecture – System design: module types, UI/Domain/Data layers, offline-first.
  • Development Guidelines – Project-specific conventions and quick β€œdo’s & don’ts.”
  • Code Quality Guide – Style rules, static analysis tools, and security practices.
  • Testing Guide – Test layers, frameworks, and best practices.

πŸ” Reviews & Collaboration​

  • Git Commit Guide – How to write clear, Conventional Commit-style messages.
  • Code Review Guide – Expectations for PR authors and reviewers, review etiquette.

🌐 Translations​

  • Translations – How to help localize Thunderbird for Android via Weblate.
  • Managing Strings – Developer guide for adding/changing/removing strings, languages, and handling Weblate sync.

Thank You​

Thank you for taking the time to contribute to Thunderbird for Android! We appreciate your help in making the project better and more useful for everyone.