Real-Time Progress Tracking
Your progress is tracked at two levels:Quest-Level Progress
userQuests records track each quest you start:- startedAt - Timestamp when you began the quest
- completedAt - Timestamp when you finished (undefined until complete)
- questId - Reference to the specific quest
Location-Level Progress
userLocations records track each location you complete:- locationId - Which location you completed
- questId - Which quest it belongs to
- photoStorageId - Reference to your verification photo
- completedAt - Timestamp of completion
All progress is automatically synced in real-time. You never need to manually save your progress.
Viewing In-Progress Quests
On the main Quests screen under the Empfohlen tab:- Quests you’ve started show a play circle icon
- These quests have a
startedAttimestamp but nocompletedAttimestamp - Tapping them shows “Quest fortsetzen” instead of “Quest starten”
Quest Detail Progress
When viewing a quest’s detail screen:For New Quests
- Shows “Quest starten” button
- No progress indicators
For In-Progress Quests
- Shows “Quest fortsetzen” button
- Automatically determines which location you should continue from
- Skips completed locations and takes you to the next incomplete one
Resume Logic
Quest Hunter intelligently calculates where to resume:- Gets all locations for the quest (ordered by sequence)
- Gets all your completed locations
- Finds the first location not in your completed set
- Navigates you directly to that location
Completing a Quest
When you complete the final location:Tap 'Quest abschliessen'
The button changes from “Weiter” to “Quest abschliessen” on the last location.
See completion dialog
A dialog appears: “Quest abgeschlossen! Du hast diese Quest erfolgreich abgeschlossen.”
What Happens at Completion
Behind the scenes:- Quest Hunter validates all locations are completed
- Sets the
completedAttimestamp on your userQuest record - The quest moves from “Empfohlen” to the “Fertig” tab
- You earn the quest’s XP points
Quest completion requires ALL locations to have verification photos. If any location is missing, you’ll see an error: “Quest not finished”.
Viewing Completed Quests
Switch to the Fertig (Done) tab to see your achievements:- All quests with a
completedAttimestamp appear here - Quest cards show a checkmark circle icon
- Cards appear slightly faded (75% opacity)
- You can tap to view details but can’t restart completed quests
Completion History
Each completed quest preserves:- When you started (
startedAt) - When you finished (
completedAt) - All location photos you uploaded
- XP earned
Progress States
A quest can be in one of three states:| State | Tab | Indicator | Status |
|---|---|---|---|
| Available | Empfohlen | Chevron → | Not started, ready to begin |
| In Progress | Empfohlen | Play circle ▶ | Started but not finished |
| Completed | Fertig | Checkmark ✓ | All locations done, XP earned |
Preventing Duplicate Progress
Quest Hunter prevents duplicate work:- Can’t start a quest that’s already in progress
- Can’t start a quest that’s already completed
- Can’t complete a location twice
- Can’t complete a quest without completing all locations
Empty States
If you haven’t completed any quests yet:- The Fertig tab shows: “Noch nichts abgeschlossen”
- Message: “Starte eine Quest und schliesse sie ab, um sie hier zu sehen.”
- This encourages you to complete your first quest
Progress Persistence
Your progress is permanent:- Survives app restarts
- Synced across devices (if logged in with the same account)
- Photos stored securely in cloud storage
- Can be viewed indefinitely in the Fertig tab
Related Features
Browsing Quests
Learn how to discover new quests
Starting a Quest
Begin your quest adventure