---
title: Smoke Test Checklist
updated: 2026-04-01
---

A manual walkthrough to verify core functionality after a build. Each section covers a
feature area with steps and expected outcomes.
Test on both iOS and Android unless noted otherwise.

---

## 1. Authentication

### OAuth Login

- [ ] Launch app → Login screen appears
- [ ] Enter a valid handle and tap "Sign in with BlueSky"
- [ ] System browser opens → complete OAuth flow
- [ ] Redirected back to app → Home feed loads

### App Password Login (Debug only)

- [ ] Toggle to app-password mode
- [ ] Enter handle + app password (xxxx-xxxx-xxxx-xxxx)
- [ ] Tap sign in → Home feed loads

### Session Restore

- [ ] Kill and relaunch app → session restores without login prompt
- [ ] Token refresh works silently (wait for expiry or force)

### Logout

- [ ] Log out from settings → returns to login screen
- [ ] Relaunching app shows login screen (session cleared)

---

## 2. Home Feed

### Feed Loading

- [ ] Following feed loads with posts on launch
- [ ] Pull-to-refresh fetches new posts
- [ ] Scroll down → infinite pagination loads more posts

### Post Cards

- [ ] Posts display: avatar, name, handle, relative timestamp
- [ ] Rich text renders correctly (mentions, links, hashtags highlighted)
- [ ] Image embeds display (single + multi-image grids)
- [ ] Video embeds display with thumbnail
- [ ] Link card embeds render (title, description, thumbnail)
- [ ] Quote posts render inline
- [ ] Engagement counts shown (likes, reposts, replies)

### Post Actions

- [ ] Tap like → icon fills, count increments (optimistic)
- [ ] Tap like again → unlike, count decrements
- [ ] Tap repost → menu: "Repost" and "Quote Post"
- [ ] Repost → count increments
- [ ] Tap reply → compose modal opens with reply context
- [ ] Tap share → system share sheet
- [ ] Overflow → Save post (bookmark icon fills)
- [ ] Overflow → Copy link

### Navigation from Feed

- [ ] Tap post body → thread view opens
- [ ] Tap avatar or name → profile screen opens

---

## 3. Feed Management

- [ ] Open feed management from home screen
- [ ] Pinned feeds listed (Following + custom generators)
- [ ] Drag to reorder feeds → order persists
- [ ] Toggle pin off → feed removed from home tabs
- [ ] Add a suggested feed → appears in home tabs

---

## 4. Post Composition

### Basic Compose

- [ ] Tap compose FAB → compose screen opens
- [ ] Type text → character counter updates (max 300 graphemes)
- [ ] Mentions auto-highlight as typed
- [ ] Links and hashtags auto-highlight
- [ ] Submit → post appears in feed

### Media

- [ ] Attach 1–4 images → thumbnails shown
- [ ] Add alt text to an image
- [ ] Remove an image attachment
- [ ] Attach a video → upload progress shown
- [ ] Images and video are mutually exclusive (UI enforces)

### Reply & Quote

- [ ] Compose as reply → parent post context shown above input
- [ ] Compose as quote → quoted post shown below input

### Drafts

- [ ] Save draft → confirmation shown
- [ ] Open drafts → saved draft listed
- [ ] Load draft → text and media restored
- [ ] Submit loaded draft → posts successfully

### Scheduled Posts

- [ ] Schedule a post for a future time → confirmation shown
- [ ] Post publishes at scheduled time (background task)

## 5. Search

### Post Search

- [ ] Type query → results load
- [ ] Sort toggle: "Top" vs "Latest" works
- [ ] Tap result → thread view opens

### Actor Search

- [ ] Switch to Actors tab → type query
- [ ] Autocomplete suggestions appear as you type
- [ ] Tap result → profile screen opens

### Starter Pack Search

- [ ] Switch to Starter Packs tab → type query
- [ ] Results show pack cards
- [ ] Tap result → starter pack detail opens

### Search History

- [ ] Recent searches appear below search bar
- [ ] Tap history item → re-executes search
- [ ] Swipe to delete a single entry
- [ ] "Clear all" removes all history

## 6. Notifications

### Notification List

- [ ] Alerts tab shows notifications (likes, reposts, follows, mentions, replies, quotes)
- [ ] Grouped by day
- [ ] Unread count badge on nav tab
- [ ] Tap notification → navigates to post or profile
- [ ] "Mark all as read" clears unread badge

### Unread Polling

- [ ] Leave app open → badge count updates (30s poll interval)

## 7. Direct Messages

### Conversation List

- [ ] Messages sub-tab shows conversations sorted by recency
- [ ] Unread count per conversation displayed
- [ ] Requests sub-tab shows unanswered conversations

### Message Thread

- [ ] Tap conversation → message thread opens
- [ ] Messages paginate (scroll up for older)
- [ ] Own messages right-aligned, others left-aligned
- [ ] Type and send a message → appears immediately
- [ ] Tap message → copy option

### Conversation Actions

- [ ] Mute conversation from overflow → muted indicator shown
- [ ] Unmute → indicator removed

## 8. Profile

### Own Profile

- [ ] Profile tab shows: banner, avatar, display name, handle, bio
- [ ] Follower/following/post counts displayed
- [ ] Posts tab → author's posts (no replies)
- [ ] Replies tab → posts and threads
- [ ] Media tab → only posts with media
- [ ] Lists tab → lists created by user (Curation | Moderation sub-tabs)
- [ ] Packs tab → starter packs created by user

### Other User's Profile

- [ ] Tap user anywhere → their profile loads
- [ ] Follow button shown → tap to follow → button changes
- [ ] Unfollow → button reverts
- [ ] Overflow: Mute, Block, Report, Copy DID, Share

### Suggested Follows

- [ ] Overflow → "Suggested Follows" → sheet with suggestions
- [ ] Follow/unfollow buttons in sheet work

## 9. Profile Context (Constellation)

- [ ] Open profile context from profile overflow menu
- [ ] **Blocked By** tab: shows count, "Show accounts" expands list
- [ ] Paginated account tiles load
- [ ] **Blocking** tab: shows outgoing blocks (own profile only)
- [ ] Shows "unavailable" message for other profiles
- [ ] **Lists** tab: shows lists user is a member of
- [ ] List cards display: name, owner, purpose badge, description
- [ ] Tap account → navigates to profile
- [ ] Tap list → navigates to list detail

## 10. Post Thread

- [ ] Thread loads: parent chain above, replies below
- [ ] Root post visually highlighted
- [ ] Nested reply chains render correctly
- [ ] All post actions work within thread (like, repost, reply, save)
- [ ] Tap profile in thread → profile screen

## 11. Lists

### My Lists

- [ ] Navigate to lists screen
- [ ] Curation and Moderation tabs separate lists correctly
- [ ] Tap list → detail screen

### Create List

- [ ] Tap FAB → create dialog
- [ ] Enter name (1–64 graphemes), optional description, pick avatar
- [ ] Select purpose (curation or moderation)
- [ ] Save → list appears in My Lists

### List Detail

- [ ] Header: name, avatar, description, creator, member count
- [ ] Feed tab (curation lists): shows posts from members
- [ ] Members tab: lists member profiles
- [ ] Overflow: Edit, Delete, Add/Remove members

### List Members

- [ ] Search for actors to add
- [ ] Add member → appears in list
- [ ] Remove member → removed from list

### Moderation Actions

- [ ] Mute list → all members muted
- [ ] Block via list → all members blocked

## 12. Starter Packs

### Starter Pack Detail

- [ ] Header: name, description, creator
- [ ] Stats: joined this week, joined all-time
- [ ] Sample members displayed (up to 12)
- [ ] Recommended feeds displayed (up to 3)
- [ ] "See all members" → navigates to list members
- [ ] "Follow all" → follows all members (with confirmation)

### Create Starter Pack

- [ ] Tap create from own profile's Packs tab
- [ ] Enter name (max 50 graphemes), optional description
- [ ] Search and add members
- [ ] Pick up to 3 feeds
- [ ] Save → pack appears on profile

### Edit / Delete

- [ ] Edit pack → update name, description, feeds
- [ ] Delete pack → removed from profile

## 13. Media

### Image Viewer

- [ ] Tap image → full-screen viewer
- [ ] Pinch to zoom, pan around
- [ ] Multi-image post → swipe between images
- [ ] Alt text shown at bottom (if present)
- [ ] Download → saved to gallery
- [ ] Share → system sheet
- [ ] Swipe down → dismiss viewer

### Video Player

- [ ] Tap video → full-screen player
- [ ] Play/pause, seek bar, mute controls work
- [ ] Elapsed/total time displayed
- [ ] Fullscreen toggle works

### Long-Press Context Menu

- [ ] Long-press image thumbnail → Save / Share options

---

## 14. Saved Posts

- [ ] Navigate to saved posts screen
- [ ] Previously saved posts listed
- [ ] Tap post → thread view
- [ ] Unsave → removed from list
- [ ] Empty state shown when no saved posts

---

## 15. Moderation & Labelers

### Content Filtering

- [ ] Blurred content shows click-through overlay
- [ ] Alert badge renders on warned content
- [ ] Filtered content hidden from feeds
- [ ] Media blur shows blurred images, text visible

### Labeler Management

- [ ] Settings → Moderation → labeler list shown
- [ ] Tap labeler → detail with label definitions
- [ ] Toggle per-label preference (ignore/warn/hide)
- [ ] Subscribe to new labeler
- [ ] Unsubscribe from labeler
- [ ] Adult content toggle gates 18+ labels

---

## 16. Connectivity & Offline

### Network Loss

- [ ] Disable network → offline banner appears at top
- [ ] Cached feed data still displays
- [ ] Post actions (like, repost, compose) disabled with tooltip
- [ ] Notifications/DMs show empty or cached state

### Network Restore

- [ ] Re-enable network → banner disappears
- [ ] Actions re-enabled
- [ ] Pull-to-refresh loads fresh data

### Optimistic Updates

- [ ] Like a post on slow connection → UI updates immediately
- [ ] If API fails → UI rolls back, error snackbar shown

---

## 17. Settings & Preferences

### Theme

- [ ] Change theme palette (Oxocarbon, Catppuccin, Nord, Rosé Pine)
- [ ] Toggle Light / Dark / System mode
- [ ] Theme applies immediately across all screens

### Account Switching

- [ ] Open account switcher → all accounts listed
- [ ] Switch to another account → feeds/profile reload for new account
- [ ] Add new account → OAuth flow → account added to list

### Dev Tools

- [ ] Logs: view logs, filter by level, search text, share log file
- [ ] PDS Explorer: resolve handle, browse collections, view record JSON

### About

- [ ] App version and build number displayed
- [ ] Licenses accessible

---

## 18. Cross-Cutting Concerns

### Navigation

- [x] Bottom nav switches between Home, Search, Alerts, Profile
- [x] Back button / swipe-back navigates correctly through stack
- [ ] Deep link to a post URI opens thread view

### Performance

- [ ] Feed scroll is smooth (no jank)
- [ ] Image loading doesn't block UI
- [ ] Search results appear within reasonable time

### Error States

- [ ] Invalid handle on login → error message shown
- [ ] Network error on post submit → error snackbar, draft preserved
- [ ] 404 on deleted post → appropriate error state

### State Persistence

- [ ] Kill app mid-scroll → relaunch restores session
- [ ] Drafts survive app restart
- [ ] Saved posts survive app restart
- [ ] Search history survives app restart
- [ ] Theme selection survives app restart