PRAXIS

PRAXIS is an iOS-first behavior engine that turns real-world execution into RPG progression.

You do the work. PRAXIS closes the feedback loop instantly with quests, XP, Gold, boss damage, and visible character growth.

Internal Xcode target names remain GAMELIFE for project continuity. User-facing product name is PRAXIS.

TL;DR

iOS productivity app with RPG systems (quests, bosses, stats, leveling, economy)
Auto-tracking via HealthKit and Location
Dynamic Bosses that react to real metric progress (weight, body fat, savings, workout consistency, steps, sleep, hydration, mindfulness, distance)
In-app language switching with German, Russian, French, Italian, and Spanish support
Home Screen widgets for status, next-up quests, and boss progress, plus Lock Screen widgets (circular, rectangular, inline) on iPhone and iPad
CloudKit sync, watchOS companion, onboarding, achievements, and configurable death/streak mechanics
GitHub-style quest completion heatmap on the Status screen and an in-app FAQ in Settings

Product Thesis

Most productivity tools are informational. PRAXIS is motivational infrastructure.

Real life fails on three things games do exceptionally well:

Clear objectives
Immediate feedback
Meaningful stakes

PRAXIS implements all three so discipline feels like progression, not friction.

Core Loops

1) Quest Loop

Tracking types: manual, healthKit, location, timer
Cadence: hourly, daily, semi-weekly, weekly, monthly
Optional quests:
- grant XP and stat growth
- grant no Gold
- do not apply missed-quest HP damage
Quest creation opens as slides: Quick Quest first for ADHD-friendly task capture, with a top button or swipe into the full quest builder for deeper setup.
Multi-step quests support dropdown subtasks, with each subtask awarding a proportional share of the quest XP, Gold, stat XP, and linked boss damage
Metric quests support incremental progress bars and diagnostics
Reminders and completion flows are integrated

2) Boss Loop

Standard bosses: fixed HP, quest completions deal damage
Dynamic bosses (metric-driven):
- weight goal
- body fat goal
- savings goal
- workout consistency
- step goal
- sleep goal
- hydration goal
- mindfulness goal
- distance goal
Dynamic configurations can auto-generate linked quests

3) Training Loop

Structured focus sessions with complete/fail outcomes
Hooks into XP, logs, and stat progression

4) Risk + Recovery Loop

HP drops for missed required behavior
Death mechanic (toggleable penalties):
- one-rank demotion
- rank-scaled stat reduction
- 20% Gold loss
- HP reset
- post-death report modal
If penalties are disabled, HP still depletes

5) Mastery + Identity Loop

Six attributes: STR, INT, AGI, VIT, WIL, SPI
Attribute-driven class titles: an auto title derived from your dominant stats + level (Apprentice → Scholar → Grand Wizard, plus dual-stat hybrids), shown alongside the separate level rank. Players can pin any earned title or return to Automatic from the profile
Trophy Room + achievements with rarity tiers and rewards
Persistent display preferences on Status dashboard

Integrations (Neural Links)

HealthKit

Auto-progress and auto-complete for eligible health/activity quests
Per-quest sync diagnostics

Core Location

Apple Maps address validation
Geofence + dwell-time tracking
Location status and progress surfaced in quest cards

Notifications

Immediate or digest completion notifications
Reminder notifications
Smart engagement reminders learn likely return windows on-device
Inactivity shutdown logic pauses notifications after prolonged disengagement
Foreground iOS banners suppressed while actively using PRAXIS (in-app feedback remains)

CloudKit

Private DB sync across Apple devices
No Sign in with Apple required for private CloudKit sync

watchOS

Watch app + extension included
Watch targets are wired into the Xcode project and shared scheme
WatchConnectivity relay for snapshots and quest actions

Feature Highlights

Status dashboard with radar/grid stat toggle and persisted preference
Slide-based quest creation with two Glasswork-styled modes — Express (quick capture: starter templates, difficulty, XP preview, attribute selection, optional reminder + three-step breakdown) and Custom (full builder: tracking method, boss link, schedule) sharing one cohesive look
Swipe-to-delete (plus long-press) with confirmation on quest and boss cards
Keyboard "Done" bar and drag-to-dismiss across the quest/boss builders
Dynamic-goal bosses auto-import their current value from Apple Health (weight, steps, sleep, and more) and offer one-tap starter names
Tabbed Activity/Achievements module with persisted preference
Next Up prioritization for high-impact quests
GitHub-style quest completion heatmap with toggleable visibility
Undo completion pipeline with stat/economy reconciliation
Marketplace rewards, including health potion recovery
Haptic system with user-configurable toggle
Multiple app icons with in-app switching
Configurable default launch tab and in-app language selection
Local on-device usage analytics with export/reset controls
Widget deep links into quests and bosses
Guided onboarding flow for first-run activation

Brand + Design System

Two design directions ship side-by-side:

System (live UI) — the Solo Leveling-inspired "System" chrome currently on the tabs. Tokens in GAMELIFE/Design/SystemTheme.swift (Color · Typography · Spacing · Radius · GlowModifier · SystemCardModifier · HolographicBorderModifier).
Glasswork (live) — direction 02 of the PRAXIS redesign. Adaptive light + dark variants of the "aurora on velvet" direction:
- Dark: velvet indigo (#0B0717) + saturated pink/cyan radial wash.
- Light: warm ivory (#FAF6FF) + soft pastel pink/cyan wash.
GW tokens (surfaces, ink, hairlines) resolve through UIColor's trait closure, so a single token works in both modes — no view forces a colorScheme. The user's choice in Settings → Preferences → Use System Appearance / Dark Mode drives the whole app.

Lives in GAMELIFE/Views/Glasswork/:
- Views/Glasswork/Screens/ — pure-mock gallery screens used by GlassworkGalleryView (10 screens grouped by flow: Daily Loop · Combat · Economy · Ceremony). Reachable from Settings → Design Preview.
- Views/Glasswork/Live/ — production screens wired to GameEngine / MarketplaceManager. All five primary tabs are Glasswork:
  - GlassworkStatusView (Status)
  - GlassworkQuestsView + GlassworkQuestClearedModal (Quests)
  - GlassworkTrainingView (Training · 15 / 25 / 45 / 60 / 90 / custom duration picker → live timer ring ticking against gameEngine.activeDungeon. Ending early awards proportional XP / gold via gameEngine.endDungeonEarly() — no penalty, just partial credit for time invested. Active view also shows live elapsed time, earned-so-far totals, and a breathing-dot status.)
  - GlassworkBossesView + GlassworkBossFightView (Bosses · tap a pending micro-task or STRIKE NOW to deal damage)
  - GlassworkShopView (Shop · featured hero + category filter + tappable 2-col grid bound to MarketplaceManager.availableRewards) Auxiliary surfaces:
  - GlassworkActivityLogView — full system log grouped by day, bound to gameEngine.recentActivity. Reached from Status → MOMENTS card → "VIEW ALL". Ceremony moments overlay over the tabs:
  - GlassworkLevelUpView — heavy aurora + gold rays + prev→new numerals + UNLOCKED rewards. Auto-fires when gameEngine.showLevelUpAlert flips true.
  - DeathPenaltySummaryView (in MainTabView.swift) — danger- tinted aurora, [ SYSTEM · DEFEAT ] header, RANK / CURRENCY / STAT LOSS Glasswork cards. Fires from gameEngine.deathPenaltySummary.
  Outer chrome:
  - SplashView now uses the Glasswork velvet/ivory background, aurora wash, default Prism mark, gradient PRAXIS wordmark, and bracketed System status label so launch matches the live tabs.
  - MainTabView tab-bar tint = GW.cyan so selected tab icons read in System cyan.
  - SystemMessageBanner (used by SystemMessageHelper.show…) re-skinned to the [ SYSTEM · TITLE ] bracket motif with accent hairline + dual shadow.
  - Settings + AppIconPicker + Permissions screens + Quest Form
    - Boss Form + Onboarding + First Launch all sit on the velvet+aurora backdrop with toolbarBackground = GW.bg and accentColor = GW.cyan — same engine logic, new chrome.
- Views/Glasswork/BrandGuidelinesView.swift — in-app rendering of the PRAXIS Brand Guidelines v1.0 (cover, palette with usage proportions, type stack, voice samples, Prism colorways, application rules). Reachable from Settings → Design Preview → PRAXIS Brand Guidelines.

Prism brand assets

The PRAXIS Brand v1.0 package (PRAXIS 2.0/) ships into the iOS target as:

Prism alternate app icons, selectable from Settings → App Icon:
- AppIcon — Signal (cyan → pink). Primary direction.
- AppIconPrismGold — Gold (gold → amber). Ceremonial alternate.
- AppIconPrismCrimson — Crimson (pink → crimson). Boss Raid alternate.
- AppIconPrismSolar — Solar (gold → crimson). Warm alternate.
- AppIconPrismVerdant — Verdant (mint → periwinkle). Cool alternate.
Each set ships iOS 18 light / dark / tinted appearances generated from the Prism SVG geometry (see PRAXIS 2.0/brand/prism-variants.jsx). The Apple App Tint pipeline recolors the tinted asset to the user's chosen system tint.
Assets.xcassets/Praxis{Wordmark,Monogram}*.imageset/ — vector wordmark + P monogram in gradient / ink / black variants, available as Image("PraxisWordmarkGradient"), etc.
Design/PraxisBrandColors.swift — Color.px* design tokens (pxVelvet, pxSurface, pxInk, pxInkSoft, pxMute, pxCyan, pxPink, pxGold, pxAmber, pxGood, pxDanger) and LinearGradient.pxSystem.
Resources/BrandTokens/ — colors.css, colors.scss, tokens.json for web / cross-platform consumers.

The HTML brand guidelines (PRAXIS Brand Guidelines.html, Brand Board.html, Prism Icons.html) and their supporting JSX live in PRAXIS 2.0/ as the canonical reference; they are not bundled into the app.

Architecture

flowchart LR
    User(("User"))

    subgraph App["iOS App Target: GAMELIFE"]
        direction TB

        Root["GAMELIFEApp\nRootView\nSplash / FirstLaunchSetup / MainTabView"]
        Tabs["SwiftUI Tabs\nStatus · Quests · Training · Bosses · Shop\nSettings + onboarding flows"]

        Engine["GameEngine @MainActor\nCanonical game state\nPlayer · Quests · Bosses · Activity Log\nXP · Stats · Gold · HP · Streaks\nQuest completion / undo · boss damage · death mechanics"]

        subgraph Services["Service Managers"]
            direction LR
            HealthSvc["HealthKitManager\nDaily metrics + observer queries"]
            LocationSvc["LocationManager\nQuest geofences + dwell time"]
            NotifySvc["NotificationManager\nQuest reminders + engagement alerts"]
            CloudSvc["CloudKitSyncManager\nPrivate DB snapshot sync"]
            WatchSvc["WatchConnectivityManager\niPhone to Watch snapshots + commands"]
            TrainingSvc["TrainingManager\nFocus sessions + fail/complete outcomes"]
            MarketSvc["MarketplaceManager\nRewards + consumables"]
            AnalyticsSvc["AnalyticsManager\nLocal usage analytics"]
            PermissionSvc["PermissionManager\nNeural Link setup state"]
            DeepLinkSvc["DeepLinkManager\npraxis:// route handling"]
        end

        subgraph LocalState["Local State"]
            direction LR
            Defaults["UserDefaults JSON stores\nPlayerDataManager\nQuestDataManager\nActivityLogDataManager\nLocationDataManager\nSettingsManager"]
            RuntimeCache["RuntimeCacheManager\nQuest order\nHealth daily snapshot\nLocation runtime snapshot\nAchievement / marketplace / status UI cache"]
            AppGroup["App Group files\ngroup.com.gamelife.shared\nWidgetSnapshotPayload + language preference"]
        end
    end

    subgraph Extensions["Companion Surfaces"]
        direction TB
        Widgets["PRAXISWidgets\nStatus widget\nNext Up widget\nBoss widget"]
        Watch["GAMELIFEWatch + Extension\nWatchHomeView\nWatchSessionStore"]
    end

    subgraph Apple["Apple Frameworks"]
        direction TB
        HealthKit["HealthKit\nSteps · workouts · sleep · stand\nWater · mindfulness · distance\nWeight · body fat"]
        CoreLocation["Core Location + Maps\nAuthorization\nGeofence monitoring\nAddress validation"]
        UserNotifications["UserNotifications\nLocal reminders\nCompletion alerts\nInactivity shutdown"]
        CloudKit["CloudKit Private Database\nGameStateSnapshot records\nDebounced uploads\nForeground / timer fetches"]
        WatchConnectivity["WatchConnectivity\nApplication context\nReachable messages\nQueued quest completions"]
        WidgetKit["WidgetKit\nTimeline reloads\nDeep links back into app"]
    end

    User --> Root --> Tabs
    Tabs <-->|"@EnvironmentObject + @Published updates"| Engine
    Tabs -->|"User actions\ncreate / complete / undo\ntrain / buy / configure"| Engine
    Tabs -->|"Pull to refresh"| HealthSvc
    Tabs -->|"Location refresh"| LocationSvc
    Tabs -->|"Permission setup"| PermissionSvc

    HealthKit <-->|"read-only authorization\nmetric refresh"| HealthSvc
    HealthSvc -->|"healthKitDataDidUpdate\nprogress + auto-completion"| Engine

    CoreLocation <-->|"monitor regions\nlocation updates"| LocationSvc
    LocationSvc -->|"locationVisitCompleted"| Engine

    Engine -->|"schedule / refresh reminders"| NotifySvc --> UserNotifications
    Engine -->|"training rewards / failures"| TrainingSvc
    Engine -->|"shop purchases / recovery items"| MarketSvc
    Engine -->|"feature + screen events"| AnalyticsSvc
    PermissionSvc --> HealthSvc
    PermissionSvc --> LocationSvc
    DeepLinkSvc -->|"route tab + target item"| Tabs

    Engine <-->|"load on launch\nsave every 30s + on mutation"| Defaults
    HealthSvc --> RuntimeCache
    LocationSvc --> RuntimeCache
    Defaults --> Engine

    Engine -->|"save()"| AppGroup
    AppGroup --> Widgets
    Widgets --> WidgetKit
    WidgetKit -->|"praxis://status\npraxis://quests\npraxis://bosses"| DeepLinkSvc

    Engine -->|"queueUpload\n1.5s debounce"| CloudSvc
    CloudSvc <-->|"latest snapshot if newer"| CloudKit
    CloudSvc -->|"apply remote snapshot"| Engine

    Engine -->|"publishSnapshot"| WatchSvc
    WatchSvc <-->|"snapshot + completeQuest command"| WatchConnectivity
    WatchConnectivity <-->|"application context / messages"| Watch
    Watch -->|"complete quest from wrist"| WatchConnectivity

Source of Truth

GameEngine (@MainActor) owns canonical game state:

player profile
quests
bosses
activity logs
penalties
training sessions
achievements

It also executes:

XP/level/rank transitions
stat mutations
quest completion and undo logic
boss damage and dynamic boss recalculation
risk/death mechanics
sync orchestration hooks

Services

HealthKitManager
LocationManager
NotificationManager
CloudKitSyncManager
WatchConnectivityManager
TrainingManager
PenaltyManager
MarketplaceManager
HapticManager

Targets

GAMELIFE (iOS app)
GAMELIFEWatch (watch app)
GAMELIFEWatchExtension (watch extension)

Performance + Local Caching

PRAXIS keeps runtime snapshots to reduce recomputation and improve launch/resume responsiveness.

RuntimeCacheManager caches:

quest ordering
daily HealthKit snapshot
runtime location state
achievement progress
marketplace catalog
status UI state

Currently wired:

local-first HealthKit daily loads
daily HealthKit snapshot persistence
location state restore on launch

Quickstart

Requirements

macOS + Xcode 16+
iOS 18+ simulator/device
watchOS SDK for companion watch builds
Apple Developer account for full entitlement testing

Build

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcodebuild -project GAMELIFE.xcodeproj \
  -target GAMELIFE \
  -configuration Debug \
  CODE_SIGNING_ALLOWED=NO \
  SYMROOT=/tmp/gamelife_build_symroot \
  OBJROOT=/tmp/gamelife_build_objroot \
  build

Simulator scheme builds need a matching watchOS simulator runtime because the iOS app embeds the watch app.

Run regression checks

bash Tests/run_regression_checks.sh

Capabilities + Entitlements Checklist

iOS target (`GAMELIFE`)

iCloud + CloudKit
HealthKit
App Groups (group.com.gamelife.shared)
Location permissions (When In Use, Always and When In Use)
Health usage descriptions in Info.plist

Beta / Release Readiness Notes

Simulator logs include framework noise (WatchConnectivity pairing, LaunchServices, haptics, RenderBox). Validate final behavior on physical devices.
WCSession counterpart app not installed is expected when watch app is not paired/installed.
iOS notification history may show stale icon assets after icon swaps due to system caching.

Privacy Model

Health and location data are used strictly for quest automation.
User game state is local-first and can sync to the user’s private CloudKit.
App-group storage is used for app/extension communication.

Roadmap Focus

Current beta core is stable. Near-term priorities:

Reliability hardening for all automation paths
Entitlement readiness for distribution environments
Metrics-driven balancing of risk/reward loops
Continuous UX refinement from beta feedback

Built for people who want execution to feel like progression.

Name		Name	Last commit message	Last commit date
GAMELIFE.xcodeproj		GAMELIFE.xcodeproj
GAMELIFE		GAMELIFE
GAMELIFEWatch		GAMELIFEWatch
GAMELIFEWatchExtension		GAMELIFEWatchExtension
PRAXISWidgets		PRAXISWidgets
Tests		Tests
.gitignore		.gitignore
PRAXISWidgets-Info.plist		PRAXISWidgets-Info.plist
PRIVATE_ASSETS.md		PRIVATE_ASSETS.md
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation