How to use the website

Questoria is a gamified world: you earn coins and XP by playing mini-games, reading stories, and doing tasks. This page explains the main areas and how to connect your account.

1. Create an account (recommended)

Most progress is stored on the server. Open Account to register or log in. New accounts start with 100 coins.

After you sign in, a secure token is saved in this browser. Mini-games can submit your score and award coins through the API.

2. Home & intro

From Home you can enter the realm and browse the high-level feature cards. Use the top navigation to move between areas.

3. Games (The Proving Grounds)

Go to Games. When logged in, finishing a run sends your score to the server. Coin rewards use tier rules defined for each game.

Memory Tap — watch the color pattern, then repeat it. Quick Reflex — when the area turns green, click as fast as you can, five times.

4. Stories

Under Stories you follow branching fiction. (Full flow can be wired to the API: list stories, make choices, save progress per chapter.)

5. Tasks & daily play

On Tasks you complete quests (game, story, or external) for one-time rewards. Claim daily rewards from the app connected to the API to keep a streak.

6. Market & inventory

Spend coins on Market for avatars, skins, and boosters. Some items can be equipped from your inventory when the UI calls the API.

7. Leaderboard & referrals

Compare XP or coins on the Leaderboard (when linked to the API). Invite friends with your referral code so you both benefit when they register.

8. Admin: manage tasks

If your account has the admin flag, open Admin (or use the Admin link in the nav). There you can create, edit, and delete tasks shown on the Hero Board. Seeded admin user: admin@admin.com / password (change in production).

9. For developers: REST API

All features are available as JSON under /api/v1 on this site, for example:

POST /api/v1/auth/register  |  POST /api/v1/auth/login  |  GET /api/v1/auth/me

POST /api/v1/games/{slug}/scores (Authorization: Bearer token)

GET /api/v1/admin/tasks — create/update/delete tasks (admin only)

Send Authorization: Bearer <token> and Accept: application/json for protected routes.