Onboarding: E2E test + docs/strings #31

Closed
opened 2026-07-01 03:49:21 +00:00 by JMR-dev · 0 comments
JMR-dev commented 2026-07-01 03:49:21 +00:00 (Migrated from github.com)

Part of #9.

Context

Final polish for the onboarding epic: an end-to-end test of the flow plus the docs/strings
cleanup the earlier tickets defer. Per-unit tests live in their own tickets (#28, #29);
this ticket covers the cross-screen E2E path and documentation.

Scope

  • Instrumented onboarding E2E test: fresh install (no accounts) -> welcome -> picker ->
    add an account (GreenMail-backed IMAP/SMTP for the app-password/manual path) ->
    "add another?" -> land on the first account's inbox.
  • Register the test in the E2E matrix. Keep the Gradle Managed Devices list in
    app/build.gradle.kts in lockstep with the E2E matrix in .github/workflows/ci.yml
    (per CLAUDE.md).
  • README reconciliation: the "Gmail account setup (OAuth client)" section and the
    "no stored passwords for Gmail" claim now conflict with onboarding's app-password
    approach (see #9 decision log). Update the README to describe Gmail/Yahoo/iCloud as
    app-password vendors in onboarding, and note the app-password prerequisites
    (e.g. Gmail requires 2-Step Verification).
  • strings.xml audit for all new onboarding copy; confirm every new source file starts
    with the // SPDX-License-Identifier: GPL-3.0-or-later header.
  • Run the fast CI gate (/preflight: assembleDebug + testDebugUnitTest + lintDebug).

Acceptance criteria

  • The onboarding E2E test passes on the managed-device matrix in CI.
  • README no longer contradicts the shipped Gmail auth behavior.
  • ktlint/detekt/lint clean; all new files SPDX-headed.

Relevant files

  • app/src/androidTest/kotlin/org/libremail/ui/... (new E2E test)
  • app/build.gradle.kts, .github/workflows/ci.yml (managed devices <-> E2E matrix)
  • README.md, app/src/main/res/values/strings.xml

Dependencies

Depends on #26-#30 being in place.

Part of #9. ## Context Final polish for the onboarding epic: an end-to-end test of the flow plus the docs/strings cleanup the earlier tickets defer. Per-unit tests live in their own tickets (#28, #29); this ticket covers the cross-screen E2E path and documentation. ## Scope - [ ] Instrumented onboarding E2E test: fresh install (no accounts) -> welcome -> picker -> add an account (GreenMail-backed IMAP/SMTP for the app-password/manual path) -> "add another?" -> land on the first account's inbox. - [ ] Register the test in the E2E matrix. Keep the Gradle Managed Devices list in `app/build.gradle.kts` in lockstep with the E2E matrix in `.github/workflows/ci.yml` (per CLAUDE.md). - [ ] **README reconciliation:** the "Gmail account setup (OAuth client)" section and the "no stored passwords for Gmail" claim now conflict with onboarding's app-password approach (see #9 decision log). Update the README to describe Gmail/Yahoo/iCloud as app-password vendors in onboarding, and note the app-password prerequisites (e.g. Gmail requires 2-Step Verification). - [ ] `strings.xml` audit for all new onboarding copy; confirm every new source file starts with the `// SPDX-License-Identifier: GPL-3.0-or-later` header. - [ ] Run the fast CI gate (`/preflight`: assembleDebug + testDebugUnitTest + lintDebug). ## Acceptance criteria - The onboarding E2E test passes on the managed-device matrix in CI. - README no longer contradicts the shipped Gmail auth behavior. - ktlint/detekt/lint clean; all new files SPDX-headed. ## Relevant files - `app/src/androidTest/kotlin/org/libremail/ui/...` (new E2E test) - `app/build.gradle.kts`, `.github/workflows/ci.yml` (managed devices <-> E2E matrix) - `README.md`, `app/src/main/res/values/strings.xml` ## Dependencies Depends on #26-#30 being in place.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: JMR-dev/LibreMail#31