thunderbird / thunderbird/thunderbird-android

Convert XML screens to Compose

Open
#9,301 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

type: enhancement type: UI/UX
Dominant language
Kotlin
Stars
14k
Forks
2.8k
Avg merge
3d 3h
Merged PRs (30d)
57

Description

The goal is to gradually replace XML based views / screens with composables. The view should be a 1 to 1 conversion with minimal changes to the design. If there are better alternatives in the design system they should be preferred .

In scope

Settings (global + per-account) and About
  • Entrypoints:
    • com.fsck.k9.ui.settings.SettingsActivity (main settings hub)
    • com.fsck.k9.ui.settings.general.GeneralSettingsActivity
    • com.fsck.k9.ui.settings.account.AccountSettingsActivity
  • Fragments and related pieces:
    • com.fsck.k9.ui.settings.account.AccountSettingsFragment
    • com.fsck.k9.ui.settings.account.AccountSettingsViewModel
    • com.fsck.k9.ui.settings.account.AccountSettingsDataStore + AccountSettingsDataStoreFactory
    • com.fsck.k9.ui.settings.account.AccountSelectionSpinner
    • com.fsck.k9.ui.settings.AboutFragment
    • com.fsck.k9.ui.settings.SettingsActionItem, UrlActionItem
    • com.fsck.k9.ui.settings.account.OpenPgpAppSelectDialog
    • com.fsck.k9.ui.settings.account.AutocryptPreferEncryptDialogFragment, AutocryptPreferEncryptPreference
Accounts, Identities, and Folder management
  • Accounts & identities:
    • com.fsck.k9.activity.AccountList (accounts overview)
    • com.fsck.k9.ui.settings.account.ManageIdentities (legacy Java) and com.fsck.k9.activity.EditIdentity
    • com.fsck.k9.activity.ChooseIdentity
  • Folder management:
    • com.fsck.k9.ui.managefolders.ManageFoldersActivity
    • com.fsck.k9.ui.choosefolder.ChooseFolderActivity
Message source, changelog, push info, confirmations
  • com.fsck.k9.ui.messagesource.MessageSourceActivity
  • com.fsck.k9.ui.changelog.RecentChangesActivity
  • com.fsck.k9.ui.push.PushInfoActivity
  • com.fsck.k9.ui.notification.DeleteConfirmationActivity
  • Generic dialogs: com.fsck.k9.fragment.ConfirmationDialogFragment, com.fsck.k9.view.HighlightDialogFragment
End-to-end encryption flows (Autocrypt)
  • com.fsck.k9.ui.endtoend.AutocryptKeyTransferActivity
  • AutocryptKeyTransferPresenter, AutocryptKeyTransferViewModel
  • AutocryptSetupMessageLiveEvent, AutocryptSetupTransferLiveEvent
Base UI and shared legacy views
  • com.fsck.k9.view.RecipientSelectView, ContactBadge, StatusIndicator, NonLockingScrollView, LinearViewAnimator, ToolableViewAnimator, ViewSwitcher, ThemeUtils, etc.

Out of scope

  1. Message Compose -> #8837
  2. Message List + Search -> #8838
  3. Message View + Attachments + Crypto status/details -> #8838

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the listed settings entry points and their related fragments, view models, and data stores to identify one self-contained XML screen. Compare each screen with the existing design system and preserve its current behavior and design while replacing its view with composables. The conversion is done when the selected in-scope screen and its related UI pieces no longer depend on the XML view implementation.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
mobile
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.