Skip to content

Product Guide

Jump to bottom
Parth Mittal edited this page Feb 15, 2026 · 7 revisions

Overview

This page covers all the features and how to instructions.

  • You can follow the guide by visiting: playkhoj.com
  • Khoj is a mobile-first web app. All features are best enjoyed on phones except for creating a hunt, which is easier on the desktop.

📝 Create a Hunt

You can create new hunts by clicking on the 'Create Hunt' button in the Navbar (on desktop only) or by visiting hunt/create and following the steps mentioned below.

Steps

  1. Connect Wallet provided by ThirdWeb. Feel free to choose to login via an existing wallet or one of the social login providers like Google.
  2. Choose the right network (currently supports Moonbase Alpha, Passet Hub (unstable) and Base). Moonbase Alpha recommended.
  3. Enter the hunt details like - name, description, start/end time, theme, etc.
  4. Check the Teams Enabled checkbox if you want to enable Teams.
    • If teams are enabled, enter the max team size
  5. Upload an image for the hunt. This will be used for the NFT for the hunt, given to each participant.
  6. Add a clue by adding a description of an answer, and the coordinates of the clue.
    • Coordinates can be obtained from maps.google.com by right clicking on any point on the map. If you are on a non-Mac desktop, chances are that your location might not be super accurate. This will not be an issue on mobiles as they use the built-in GPS sensor. For easy testing, you can choose the coordinate very close to the current location being detected.
    • Repeat this process for as many clues as desired.
    • Click on the Upload Clues to IPFS button. This will encrypt the clues and their answers using Lit protocol and store their hash on IPFS.
  7. One uploaded, the Create Hunt button will become active. click on the Create Hunt button and proceed with signing the transaction.
    • Make sure to have some tokens before signing the transaction.
    • Tokens can be obtained from the respective faucet based on the network. For example, Moonbase Alpha tokens can be obtained from the faucet
image
Creating a hunt

You have now successfully created a hunt!

💎 Explore hunts & Register

  1. Head back to the base URL playkhoj.com
  2. Make sure you have connected your wallet. If not, go ahead and connect it. Feel free to choose an existing provider or login with a social provider like Google.
  3. You should see all the available hunts with details such the name, description, timeline, number of participants and whether the hunt supports teams or not.
  4. Depending on the conditions, a hunt can have the following states visible:
    • Register: The hunt is live and one can register.
    • Manage: The user is already registered and can view more details of the hunt, manage teams, etc.
    • Ended: The hunt happened in the past is no longer accepting registrations.
  5. Register for a hunt by clicking on the Register button.

Hunts

👥 Team Management

  1. Once registered, one can click on the Manage button to view more details about the hunt.
  2. Depending on whether teams are enabled for the hunt or not, a user can either directly start the hunt or create or join a team.

A. Teams Disabled

  1. Here, the user can simply click on the Start button to start the hunt.

B. Teams Enabled

If teams are enabled, a user can choose to either create a new team and invite their friends or join an existing team.

B.1 Create a Team

  1. Under the Team Management section, Create Team tab, click on the 'Create Team & Generate Invite` to create a team and generate a share-able team invite code.
  2. The invite code is a secure string, visible to the user only once. The team owner can now either share the QR or copy the string generated. This code is also not exposed on-chain allowing only users that have access to the code to join the team.
Create a Team
Create a Team 		Team invite code & QR
Team invite code & QR

B.2 Join a Team

  1. One can also choose an existing team. Under the Team Management section, switch to the Join Team tab.
  2. Paste the invite code obtained from the team owner in the input box or scan the QR shared by clicking on the Scan button.
  3. Click on the Join Team button. This will verify the invite and join the team. Once joined, the user can see their team details.
  4. Repeat this process until the maximum capacity allowed by the hunt creator.
Creating a team
Joining a team 		Team Details
Team details after joining a team

🔎︎ Solving clues

  1. Click on the Start Hunt button to begin the hunt.
  2. Make sure to allow location services access to the browser when invoked. If you are not prompted to do so, visit the Settings app of the phone to allow precise location access to the browser.
  3. The generated clue will be visible. The clue number on the top right indicates the current clue and the total number of clues in the hunt.
  4. Move to the guessed location as per the clue details and click on Verify Location. This will decrypt the clue answer and match it with the user's coordinate. The answer will be valid within a certain proximity limit (currently set to 100m).
  5. The user will get upto 6 attempts (configurable) to solve each clue.
  6. Repeat the process until all clues are solved.
  7. You can also check the Leaderboard by clicking on the chart icon on the top right of the Clue screen. Teams are ranked based on a score. Score = (Time in minutes) + (Attempts × 5). Lower scores rank higher after number of clues solved.
  8. Once all the clues are solved, the users will be granted rewards based on the score for each team. Reward distribution is currently assumed to happen offline and will be worked on in the 2nd milestone.
Solving a clue
Solving a Clue 		Leaderboard
Leaderboard 		Hunt End
Successful completion of a hunt

Feel free to leave any feedback by opening an issue. We would love to hear you! ⭐

Clone this wiki locally