Getting Started with MainQuest

Your journey from zero to hero starts here.

What is MainQuest?

MainQuest is a gamified productivity app that treats your real life like an RPG. Every task becomes a quest. Every habit becomes a stat. Every day is a chance to level up.

Instead of checking boxes on a boring to-do list, you earn XP for completing quests, grow attributes by checking in on habits, and keep your character alive by staying productive. If you slack off, your character takes HP damage β€” and if HP hits zero, your hero dies.

Step 1: Create Your Hero

When you first open MainQuest, you will create your character. Pick a hero name and choose a class that represents who you want to become.

Classes are not rigid categories β€” they are identity labels you define. A "Scholar" class might focus on learning and reading, while a "Warrior" class could emphasize fitness and discipline. You can customize the attributes your class prioritizes.

Learn more about the class system in the Classes & Attributes guide.

Step 2: Complete Your First Quest

Quests are your tasks. Tap the + button, give your quest a name, and set a difficulty level from Trivial to Legendary. Higher difficulty means more XP on completion.

Example quest difficulties:

  • Trivial: Take out the trash
  • Easy: Go for a 15-minute walk
  • Medium: Write a blog post
  • Hard: Complete a coding project
  • Legendary: Run a marathon

Once you complete the quest, you earn XP and your character levels up. For the full breakdown, read the Quests guide.

Step 3: Build Your First Habit

Habits are different from quests. They are recurring behaviors you check in on daily. Each check-in awards subpoints toward the habit's linked attribute, gradually growing your character's stats.

Start small β€” pick one habit you want to build, like "Drink 8 glasses of water" or "Read for 10 minutes." Check in consistently and watch your streak grow. Streaks are tracked with a 3 AM day boundary, so staying up past midnight will not break your streak.

Dive deeper in the Habits guide.

Step 4: Explore Your Character Sheet

Your character sheet shows everything about your hero:

  • HP (Health Points): Ranges from 0 to 100. You lose HP for abandoning quests. Level up to fully recover.
  • XP (Experience Points): Earned by completing quests. Required XP per level = 100 + (level - 1) Γ— 10.
  • Level: Your overall progress. Each level-up fully restores your HP to 100.
  • Attributes: Stats like Strength, Intelligence, etc. that grow from habit check-ins.

For the full breakdown of HP, XP, and what happens when you die, see the HP, XP & Death guide.

What to Explore Next

Morning Routine

Set up a daily morning checklist and unlock the Clarity Buff for bonus XP.

Read the Daily Rhythm guide β†’

Focus Sessions

Use the built-in focus timer to earn XP while doing deep work.

Read the Focus Sessions guide β†’

Story Mode

Pick a faction and follow a weekly narrative driven by your productivity.

Read the Story Mode guide β†’

Achievements

Unlock badges and titles as you hit productivity milestones.

Read the Achievements guide β†’

Tips

  • β˜…Start with one easy quest and one simple habit β€” don't overload yourself on day one.
  • β˜…Check in on habits at the same time each day to build consistency.
  • β˜…Your day resets at 3 AM, not midnight, so late-night tasks still count for today.
  • β˜…Explore the Dawn Scrolls feature in your morning routine for an XP boost.

Platform Notes

FeatureMobileWeb
Offline modeFull offline support with background syncRequires internet connection
Death mechanicsFull system β€” HP ≀ 0 triggers death screenHP tracked but no death screen
NotificationsPush notifications for remindersNo push notifications

Ready to Level Up?

Download MainQuest and start turning your tasks into adventures.