# Essential Smoke Tests

<br>

Minimal pre-release checklist. Covers only the highest-risk, must-pass cases. &nbsp;  
\*\*Full test suite:\*\* See [Comprehensive list](https://community.openproject.org/projects/mobile-app-spike/wiki/comprehensive-list)

\---

## 1\. Installation &amp; Update

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">1.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Fresh install</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Uninstall the app, install the new build, launch it</p></td><td class="op-uc-table--cell"><p class="op-uc-p">App opens without errors; onboarding or login screen is shown</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">1.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Update over existing install</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Install the previous release, log in, then install the new build on top<br>(this operation can be non-trivial for Android, so for a quick smoke test on Android we can rely on previous experience and omit this step)</p></td><td class="op-uc-table--cell"><p class="op-uc-p">App launches; user is still logged in, no crash</p></td></tr></tbody></table></figure>

\---

## 2\. Login &amp; Authentication

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">2.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Sign in with valid credentials</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Enter a valid instance URL, email, and password; tap Sign In</p></td><td class="op-uc-table--cell"><p class="op-uc-p">User reaches the Home dashboard</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">2.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Sign in with wrong credentials</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Enter a valid URL with a wrong password; tap Sign In</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error message is shown; user stays on Sign In page</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">2.3</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Session persists after restart</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Log in, close the app fully, reopen it</p></td><td class="op-uc-table--cell"><p class="op-uc-p">User lands on Home dashboard without re-login</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">2.4</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Sign out</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Navigate to Account, tap Log Out</p></td><td class="op-uc-table--cell"><p class="op-uc-p">User is returned to the Sign In screen</p></td></tr></tbody></table></figure>

\---

## 3\. Home Dashboard

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">3.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Dashboard loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Log in and open the Home tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Widgets load without errors or blank screens</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">3.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Navigate from widget</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap a work package in any Home widget</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Work Package Details screen opens</p></td></tr></tbody></table></figure>

\---

## 4\. Projects / Workspaces

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">4.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Projects list loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Workspaces tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">List of projects is displayed</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">4.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open a project</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap any project in the list</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Project overview opens with at least one tab loading correctly</p></td></tr></tbody></table></figure>

\---

## 5\. Work Packages

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">5.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Work package list loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Work Packages tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">List of work packages is displayed</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">5.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open work package details</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap any work package</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Details screen shows title, status, and description</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">5.3</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Create a work package</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap "+", fill in title, type, and project; save</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Work package is created and visible in the list</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">5.4</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Edit a field</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open a work package, change the status, save</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Updated status is shown in the details view</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">5.5</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Add a comment</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open a work package, go to Activity tab, post a comment</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Comment appears in the activity timeline</p></td></tr></tbody></table></figure>

\---

## 6\. Time Tracking

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">6.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Time tracking page loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Time Tracking tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Calendar and time entries load</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">6.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Start and stop timer</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Timer tab, tap Start, wait a few seconds, tap Stop</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Log Time form opens pre-filled with elapsed time</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">6.3</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Save a time entry</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Fill in the Log Time form and confirm</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Entry is saved and appears in the calendar view</p></td></tr></tbody></table></figure>

\---

## 7\. Global Search

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">7.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Search returns results</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open Search, type a known work package title</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Matching results appear in the list</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">7.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Navigate to result</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap a result</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Correct work package detail screen opens</p></td></tr></tbody></table></figure>

\---

## 8\. Notifications

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">8.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Notifications list loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Notifications tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Notification list is displayed (or empty state shown)</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">8.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap a notification</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap any notification</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Associated work package detail opens</p></td></tr></tbody></table></figure>

\---

## 9\. User Profile &amp; Settings

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">9.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Profile loads</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open the Account tab</p></td><td class="op-uc-table--cell"><p class="op-uc-p">User name, email, and avatar are displayed</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">9.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Settings are accessible</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Open Account → Work Package Settings</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Settings page opens without error</p></td></tr></tbody></table></figure>

\---

## 10\. Navigation &amp; Stability

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><thead class="op-uc-table--head"><tr class="op-uc-table--row"><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">#</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Use Case</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Steps</p></th><th class="op-uc-table--cell op-uc-table--cell_head"><p class="op-uc-p">Expected Result</p></th></tr></thead><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">10.1</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Bottom nav tabs all work</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Tap each icon in the bottom navigation bar</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Each tab opens its correct screen</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">10.2</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Back navigation</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Go several screens deep, press back</p></td><td class="op-uc-table--cell"><p class="op-uc-p">App navigates back correctly without crash</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">10.3</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Offline error handling</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Disable network, try to load any screen</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Error or offline message shown; app does not crash</p></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><p class="op-uc-p">10.4</p></td><td class="op-uc-table--cell"><p class="op-uc-p">No crash during basic usage</p></td><td class="op-uc-table--cell"><p class="op-uc-p">Use the app across all main sections for ~10 minutes</p></td><td class="op-uc-table--cell"><p class="op-uc-p">No crashes or unresponsive states occur</p></td></tr></tbody></table></figure>