Here is the completely updated, high-performance README tailored exactly to the new RPG mechanics, the decoupled prestige structure, and the dynamic math engine we just built into the code.
ADHDmaxxing is a zero-friction, fully offline gamified productivity dashboard built entirely in a single HTML file. Designed specifically to overcome executive dysfunction, this system forces absolute tunnel vision. Fight a ticking Doomsday countdown, level up across an exponential RPG curve, and systematically clear custom life chapters to unlock your real-world loot track. No ads, no tracking, no account registration, no subscriptions—just pure, unadulterated psychological leverage over your own brain.
The system has been re-engineered from the ground up to completely eliminate economic guesswork. There are no arbitrary money-to-XP conversions. The software balances itself automatically based on your real-world calendar constraints.
-
🔥 Main Quests (Heavy Focus Blocks): High-priority focus targets (+50 XP). Mandatory.
-
🛠️ Side Quests (Habit Formations): Key daily structural routines (+20 XP). Mandatory.
-
The Penalty Mechanic: Failing to check off a Mandatory Quest before your Sleep Reset hour triggers a severe rollover penalty drop (
$-1.5\times$ the quest's value). -
📜 Errands (Chores & Reminders): Single or interval events (+75 XP). Optional.
-
⭐ Bonus Quests (Wellness Wins): Extra dopamine triggers (+15 XP). Optional.
-
The Protection Mechanic: Optional quests yield high reward points but carry zero penalties if skipped.
- 🔀 Postpone (PT) Tokens: Having a critical mental health day? Expend a PT Token to safely skip a mandatory quest. It marks the quest cleared, grants 0 XP, but completely freezes the rollover penalty. You start with 3 tokens.
- 🔥 Perfect Streaks: Clear 100% of your mandatory quests for 3 consecutive days to score a Perfect Streak streak multiplier and receive +1 free PT Token.
- 🌙 Sleep Reset Anchor: Not everyone operates on a standard corporate schedule. Set your "System Reset Hour" between 12:00 AM and 6:00 AM so late-night grinds are credited to the correct calendar block.
- ❄️ Stasis Mode: Going on holiday or dealing with a severe illness? Flip the Rest / Sick Day switch in the Control Panel to completely freeze your profile state and bypass all incoming penalties.
The system completely handles the game balance for you. When you launch a new real-world chapter, you simply brain-dump your desired rewards and use the tactile up/down controls to rank them from Easiest Treat to Ultimate Prize.
The app scans your active mandatory quests, counts the exact days remaining on your countdown clock, and maps out a customized Exponential Leveling Track (
Your character level resets down to Level 1 at the end of every Doomsday to ensure you constantly experience the rapid, addictive leveling speeds of the early game. However, your lifetime survival is tracked permanently by your Cycle Counter, which scales your Avatar Frame with glowing pulsing CSS color grading via a narrowing pyramid structure:
- NOVICE I - IV (Cycles 1 - 4): Gunmetal Gray Border
- AWAKENED I - III (Cycles 5 - 7): Glowing Neon Blue Aura
- VETERAN I - II (Cycles 8 - 9): Pulsing Amethyst Purple Aura
- ELITE (Cycle 10+): Blazing Radiant Gold Aura
Upon successfully conquering your 9th milestone cycle and unlocking the legendary Elite tier, the system rewards you with the Annual Victory Celebration Screen. From there, you can choose to enter New Game Plus (Year 2), resetting the progression tracks back to baseline while adding a permanent master survivor crest to your avatar aura to showcase your lifetime achievement.
Because this program executes completely in-browser utilizing sandboxed HTML5 Local Storage architecture, you do not need an App Store to turn it into a native-feeling mobile app:
- Save your updated code text as an
index.htmlfile. - Send the file to your smartphone (via AirDrop, email, iCloud, Google Drive, or Discord).
- Open the file inside your mobile browser (Safari for iOS, Chrome for Android).
- Pin it to your phone:
- iOS / Safari: Tap the Share icon at the bottom, scroll down, and tap "Add to Home Screen".
- Android / Chrome: Tap the 3-dot menu icon at the top right, and tap "Add to Home Screen".
- Launch the app directly from your phone's home screen icon. It will open in seamless, edge-to-edge full screen, function completely offline, and maintain your state flawlessly.
This single-file offline build is the local developer prototype. The macro-vision for ADHDmaxxing is to scale this engine into a full-stack native mobile framework utilizing real-time peer-to-peer accountability systems:
- Faction Matchmaking: Automatically cluster players into real-time focus guilds based on asynchronous profiles (e.g., "The Night-Shift Nightshades", "The Bar Exam Grinders", or "The Freelance Nomads").
- Real-time PvP Duels: Wager XP in 24-hour survival sprints against other real-world players (e.g., First player to log a 3-hour focus block or log a workout steals 500 XP from the opponent's vault).
- Accountability Boss Raids: Group-based survival mechanics. Form a party of 5 to tackle a weekend campaign. The party must collectively generate 4,000 XP through focus blocks to defeat the boss. If a single party member drops their streak and incurs a penalty, the entire party takes collateral damage and fails the raid.
Feel free to fork this single-file layout, tweak the exponential scaling variables, and bend the UI theme to fit your life. Execution yields absolute clarity.