thunderbird / thunderbird/thunderbird-android

Global Database 0.1.10 - Implement legacy-to-global migration process and UX

Open
#11,467 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status: needs design tb-team type: enhancement
Dominant language
Kotlin
Stars
14k
Forks
2.8k
Avg merge
3d 3h
Merged PRs (30d)
57

Description

Implement the Android migration experience and the gate that coordinates the transition to global mail storage. Reuse the existing database-migration activity or introduce a suitable replacement for progress, completion, failure feedback, retry, and local report export.

The migration gate controls startup, sync, workers, and other mail entry points until migration completes or fails.

Acceptance criteria
  • The migration screen shows non-sensitive progress and a clear completion or failure state.
  • For a POP3 account, the user may decline the archive after an explicit warning and continue at their own risk.
  • Failure provides a next action, retry when safe, and local report export.
  • Reports exclude mail content, addresses, attachment names, paths, credentials, and tokens.
  • Startup, sync, workers, and other background mail work cannot bypass the migration gate.
  • Failure before cutover leaves legacy storage authoritative.
  • Tests cover interruption, retry, migration-gate behavior, redaction, and successful cutover.

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 tracing the existing database-migration activity and the startup, sync, worker, and other mail entry points that need to respect the migration gate. Done means the migration UX covers progress, completion, failure, retry, POP3 warning, and redacted local reports, with tests for interruption, retry, gate enforcement, redaction, and successful cutover.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
database, mobile
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.