-
Notifications
You must be signed in to change notification settings - Fork 0
User Guide
Complete guide for using SideQuest to post tasks, claim tasks, and manage your profile.
- Getting Started
- Authentication
- Exploring the Map
- Posting Tasks
- Claiming Tasks
- Managing Your Tasks
- Profile & Wallet
- Ratings & Reputation
- Open SideQuest in your web browser
- Allow location permissions when prompted (optional but recommended)
- Create an account or sign in
- You're ready to explore!
SideQuest has three main views accessible from the bottom navigation:
- 🌍 Explore: Interactive map showing all available tasks
- 📋 My Tasks: View tasks you've posted or claimed
- 👤 Profile: Manage your profile, wallet, and statistics
- Click "New to SideQuest? Sign Up"
- Enter your details:
- Name: How you'll appear to other users
- Email: For account recovery and notifications
- Password: Minimum 6 characters
- Click "Create Account"
- You'll be automatically signed in
- Enter your email and password
- Click "Sign In"
- You'll be taken to the map view
- Tap the Profile tab (👤) in bottom navigation
- Scroll down and tap "Log Out"
The interactive map is your main interface for discovering tasks:
- Zoom: Pinch to zoom on mobile, scroll on desktop
- Pan: Drag the map with your finger or mouse
- Rotate: Two-finger rotate on mobile
- Blue Marker: Your current location
- Colored Pins: Available tasks in your area
- Locate Me Button: Top the button in bottom-right to center on your location
Tasks appear as markers on the map, color-coded by category:
- 🟢 Green: Help tasks
- 🟡 Yellow: Delivery tasks
- 🟣 Purple: Social tasks
- 🔵 Blue: Other tasks
To view a task:
- Tap any marker on the map
- The task detail modal will open
Use the category filters to show only specific task types:
- Tap filter chips below the search bar:
- All: Show all tasks
- Help: General assistance
- Delivery: Pick-up and drop-off
- Social: Companionship activities
- The map will update to show only matching tasks
- Tap the search bar at the top
- Type keywords (e.g., "grocery", "dog walk")
- Matching tasks will be highlighted
Need help with something? Post a task!
- Tap the blue + button (FAB) in the bottom-right
- Fill in the task details:
- Keep it short and descriptive
- Examples: "Walk my dog", "Help move furniture", "Pick up groceries"
- Help: General assistance tasks
- Delivery: Pick-up and deliver items
- Social: Companionship, events, activities
- Other: Anything else
- Enter amount in Rupees (₹)
- If offering a reward, funds will be held in escrow
- Your current balance is shown below the input
- Leave empty for volunteer/free tasks
- Provide details about what you need
- Include any special requirements
- Be clear about timing or location specifics
- Tap "Post Task"
✅ Required:
- Title (minimum 3 characters)
- Description (minimum 10 characters)
- Valid location (uses your current position)
- If offering a reward, you must have sufficient balance
- Rewards are held in escrow until task completion
- Tasks auto-delete after 24 hours
Once posted:
- Your task appears on the map immediately
- Other users can view and claim it
- You'll receive notifications when someone claims it
See a task you can help with? Claim it!
- Browse the map for nearby tasks
- Or use filters to find specific categories
- Tap a marker to view details
When you tap a task marker, you'll see:
- Poster's name and avatar
- Posted time (e.g., "2 mins ago")
- Distance from your location
- Reward amount (if offered)
- Full description
- Read the task details carefully
- Tap "I'll do it!" button
- Confirm the claim
- The task is now assigned to you
- The task moves to your "Claimed" tab
- Task poster receives a notification
- Complete the task in real life
- Mark as complete in the app
You cannot claim tasks that you posted yourself.
Access your tasks via the 📋 My Tasks tab in bottom navigation.
Tasks you've created appear in the "Posted" tab:
- 🟢 Open: Waiting for someone to claim
- 🟡 In Progress: Someone is working on it
- ✅ Completed: Task finished and paid
View Details: Tap any task to see full information
Delete Task:
- Open task details
- Tap "Delete Task" (only shown for open tasks)
- Confirm deletion
- Escrow funds will be refunded
Tasks you're working on appear in the "Claimed" tab:
- 🟡 In Progress: Currently assigned to you
- ✅ Completed: Finished and rated
Complete Task:
- After finishing the real-world task
- Open task in "Claimed" tab
- Tap "Mark as Complete"
- Wait for poster to rate you
- Reward is released to your wallet
Cancel Claim (if needed):
- Open task details
- Tap "Cancel Claim"
- Task returns to open state
- Tap Profile tab (👤) in bottom navigation
- View your:
- Name and email
- Wallet balance
- Statistics (completed, posted, rating)
- Tap the edit icon (✏️) next to your name
- Enter new name
- Tap "Save"
- Shows total available funds
- Displayed in Rupees (₹)
- Updated in real-time
Earning Money:
- Complete claimed tasks
- Receive ratings from task posters
- Funds automatically added to wallet
Spending Money:
- Post tasks with rewards
- Funds held in escrow until task completion
- Refunded if task is deleted
When you post a task with a reward:
- Amount is deducted from your wallet
- Held in escrow (safe and locked)
- Released to claimer when task is completed
- Refunded to you if task is deleted
Note: Currently, there's no built-in top-up system. This is planned for future updates. For testing, use Firebase Console to manually update wallet amounts.
Build your reputation with the 5-star rating system!
After completing a task:
- Task poster rates your performance (1-5 stars)
- Rating is added to your profile
- Your average rating updates automatically
After someone completes your task:
- Open the completed task
- A rating modal appears
- Select 1-5 stars
- Tap "Confirm & Rate"
- Reward is released to the task claimer
⭐ 1 Star: Task not completed or major issues
⭐⭐ 2 Stars: Completed but poor quality
⭐⭐⭐ 3 Stars: Acceptable completion
⭐⭐⭐⭐ 4 Stars: Good job, minor issues
⭐⭐⭐⭐⭐ 5 Stars: Excellent work!
When viewing task details:
- Poster's rating badge is shown
- Helps you decide which tasks to claim
- Higher ratings = more trustworthy users
- Reputation: Build trust in the community
- Visibility: Higher-rated users may get priority
- Future Features: Potential for unlocks and benefits
✅ Do:
- Be specific in descriptions
- Offer fair rewards for effort required
- Respond promptly to claimers
- Rate fairly and honestly
❌ Don't:
- Post vague or unclear tasks
- Offer rewards you can't afford
- Delete tasks unnecessarily
- Ghost task claimers
✅ Do:
- Only claim tasks you can complete
- Communicate with the poster
- Complete tasks promptly
- Deliver quality work
❌ Don't:
- Claim tasks you can't finish
- Accept tasks with unclear requirements
- Abandon claimed tasks
- Rush through work
Q: How close do I need to be to claim a task?
A: There's no distance limit, but use common sense. Claim tasks you can realistically reach.
Q: What if the task poster doesn't rate me?
A: Auto-release and auto-rating systems are planned for future updates.
Q: Can I edit a task after posting?
A: Not currently. You'd need to delete and repost. Task editing is planned for future updates.
Q: How do I contact the task poster/claimer?
A: Direct messaging is planned for future updates. Currently, coordinate through task descriptions or external means.
Need assistance? Check these resources:
- FAQ - Common questions and answers
- Troubleshooting - Fix common issues
- Report an Issue - Bug reports