How loisi105/dungeons_and_deadlines works
Dungeons & Deadlines is an iOS pixel-art RPG that turns project deadlines into boss fights. Users create or join a raid, plan tasks, start the fight, then deal damage by completing tasks and running focus sessions; the app tracks phases, health, party contributions and the final report. SwiftUI feature views sit above shared game rules and SwiftData storage, while intents and widgets expose common actions on system surfaces. Multiplayer sync is optional and Firebase-backed. Several feature links are documented in the README; unsampled implementation details are not inferred.
Main entry points: GameActions.swift Shared actions · DungeonsAndDeadlinesApp.swift App and tabs · BossEngine.swift Boss rules · RaidStore.swift Raid store
Components 27
App shell
- App and tabs
DungeonsAndDeadlines/App/DungeonsAndDeadlinesApp.swift - App services
DungeonsAndDeadlines/App/AppEnvironment.swift
Raid planning
- Raid setup
DungeonsAndDeadlines/Features/Raid - Boss selection
DungeonsAndDeadlines/Features/Root/BossSwitcher.swift - Quest log
DungeonsAndDeadlines/Features/Tasks/TasksView.swift
Fight and progress
- Boss fight
DungeonsAndDeadlines/Features/Boss/BossView.swift - Focus timer
DungeonsAndDeadlines/Features/Focus/FocusView.swift - Damage meter
DungeonsAndDeadlines/Features/Meter/MeterView.swift - Raid report
DungeonsAndDeadlines/Features/Report/ReportView.swift - Boss rules
Packages/DDKit/Sources/GameCore/BossEngine.swift - Damage rules
Packages/DDKit/Sources/GameCore/DamageConfig.swift - Phase rules
Packages/DDKit/Sources/GameCore/Phase.swift - Focus session model
Packages/DDKit/Sources/GameCore/FocusSession.swift
Game state
- Raid store
Packages/DDKit/Sources/DDPersistence/RaidStore.swift - Player identity
Packages/DDKit/Sources/DDPersistence/LocalIdentity.swift - Sync coordinator
DungeonsAndDeadlines/Sync/SyncEngine.swift - Raid sync
Packages/DDKit/Sources/DDSync/RaidSync.swift - Firebase REST
Packages/DDKit/Sources/DDSync/FirebaseREST.swift
System surfaces
- Shared actions
Packages/DDKit/Sources/DDIntents/GameActions.swift - App intents
Packages/DDKit/Sources/DDIntents/Intents.swift - Widgets
DDWidgets/BossWidget.swift - Live Activity
DDWidgets/FocusLiveActivity.swift - Focus shielding
DungeonsAndDeadlines/App/FocusBlocking.swift - Screen Time rules
Packages/DDKit/Sources/DDScreenTime/ScreenTimeShield.swift - Game Center
DungeonsAndDeadlines/App/GameCenterService.swift
Other components
- Player
- Firebase
Connections 33
- Player → App and tabs: opens
README.md - App and tabs → App services: bootstraps
DungeonsAndDeadlines/App/AppEnvironment.swift - App and tabs → Raid setup: offers raid setup
README.md - App and tabs → Quest log: opens quest log
README.md - App and tabs → Boss fight: opens boss tab
README.md - App and tabs → Focus timer: offers focus timer
README.md - App and tabs → Damage meter: offers meter
README.md - App and tabs → Raid report: shows report
README.md - Raid setup → Raid store: creates raid
- Quest log → Shared actions: completes tasks
DungeonsAndDeadlines/Features/Tasks/TasksView.swift - Quest log → Raid store: edits tasks
DungeonsAndDeadlines/Features/Tasks/TasksView.swift - Boss selection → Raid setup: offers joining
DungeonsAndDeadlines/Features/Root/BossSwitcher.swift - Shared actions → Raid store: writes game state
Packages/DDKit/Sources/DDIntents/GameActions.swift - Raid store → Boss rules: derives boss state
Packages/DDKit/Sources/DDPersistence/RaidStore.swift - Boss rules → Damage rules: uses damage config
Packages/DDKit/Sources/GameCore/BossEngine.swift - Boss rules → Phase rules: uses phase rules
Packages/DDKit/Sources/GameCore/BossEngine.swift - Raid store → Focus session model: stores sessions
Packages/DDKit/Sources/DDPersistence/RaidStore.swift - Focus timer → Shared actions: controls focus
DungeonsAndDeadlines/Features/Focus/FocusView.swift - Boss fight → Shared actions: invokes game actions
DungeonsAndDeadlines/Features/Boss/BossView.swift - Damage meter → Boss rules: reads fight stats
Packages/DDKit/Sources/GameCore/BossEngine.swift - Raid report → Boss rules: presents fight results
- Shared actions → Player identity: uses player identity
Packages/DDKit/Sources/DDIntents/GameActions.swift - App intents → Shared actions: dispatches actions
- Widgets → Shared actions: shares action path
README.md - Live Activity → Shared actions: shares action path
README.md - Shared actions → Screen Time rules: reconciles shield
Packages/DDKit/Sources/DDIntents/GameActions.swift - Focus shielding → Screen Time rules: uses shield rules
DungeonsAndDeadlines/App/FocusBlocking.swift - App services → Sync coordinator: configures sync
DungeonsAndDeadlines/App/AppEnvironment.swift - Sync coordinator → Raid sync: delegates sync
DungeonsAndDeadlines/Sync/SyncEngine.swift - Raid sync → Firebase REST: uses REST
README.md - Firebase REST → Firebase: communicates with
README.md - App services → Game Center: configures service
DungeonsAndDeadlines/App/AppEnvironment.swift - App services → Shared actions: registers change callback
DungeonsAndDeadlines/App/AppEnvironment.swift