igorescodro/write-e2e-tests

Write E2E Tests

Overview

E2E tests exercise full application flows through a real Koin DI graph and a live AlkaaMultiplatformApp Compose tree. They live in shared/src/commonTest/kotlin/com/escodro/alkaa/ — one file per feature domain (e.g., TaskFlowTest, CategoryFlowTest).

Structure

• Class setup — Extends AlkaaTest(), KoinTest; @BeforeTest calls beforeTest() first, then cleans DAOs → see references/SETUP.md
• Entry point — = uiTest { } for all tests; = flakyUiTest { } only for known timing-sensitive tests → see references/SETUP.md
• Data seeding — Insert directly via DAOs in @BeforeTest using runTest → see references/SETUP.md
• Navigation helpers — Private ComposeUiTest extension functions using content descriptions → see references/SETUP.md
• Assertions — Existence, wait helpers, selection state, semantic matchers → see references/SETUP.md
• Fake dependencies — declare<T> { FakeImpl() } to override external dependencies → see references/SETUP.md

Naming

Descriptive, underscore-separated. Two styles:

• State-driven: when_no_query_then_all_tasks_are_visible()
• Action-driven: add_and_open_task(), complete_task_from_list()

No camelCase, no backtick names.

Rules

| Rule | Details | |------|---------| | beforeTest() first | Call beforeTest() before any DAO injection or by inject() use | | cleanTable() in @BeforeTest | Call on every DAO used to avoid state leakage between tests | | DAO-based seeding | Insert test data directly via DAOs — not via use cases | | Content descriptions for navigation | Navigate via content descriptions, not raw text | | Resource strings | getString(Res.string.xyz) inside uiTest or runComposeUiTest — never hardcode | | Fakes over mocks | Use declare<T> { FakeImpl() } for external dependencies | | @AfterTest always | Always call afterTest() to stop Koin after each test |

Common Mistakes

| Mistake | Fix | |---------|-----| | Calling by inject() before beforeTest() | Always call beforeTest() first | | Skipping cleanTable() | Call on every DAO to avoid state leakage | | Using flakyUiTest by default | Reserve for tests with known timing sensitivity | | Hardcoding UI strings | Use getString(...) inside uiTest or runComposeUiTest | | Testing multiple flows in one test | One scenario per test | | Missing @AfterTest / afterTest() | Always stop Koin after each test | | Navigation via raw text | Navigate via content descriptions | | Using mocks | Use fakes via declare<T> { FakeImpl() } |