Skip to main content

​
Overview

The Profile screen displays your account information synced from Clerk authentication. Your profile is automatically created when you sign in and stays synchronized with your authentication provider.

​
Profile Information

Your profile displays the following information from your Clerk account:

Profile Photo

Your avatar image from your Google account

Full Name

Your first and last name from authentication

Email Address

Your primary email address

User ID

Your unique Clerk identifier (internal)

​
Accessing Your Profile

1

Open the Profile tab

Tap the Profile icon in the bottom navigation bar. This is typically the rightmost tab in the app.
2

View your information

Your profile screen displays:
  • Profile photo (80x80 circular avatar)
  • Full name in large text
  • Email address in smaller text below

​
Profile Data Sync

Your profile information is automatically synchronized with Clerk through webhooks: 
// Profile data structure
interface UserProfile {
  imageUrl?: string;        // Google profile photo URL
  fullName: string;         // Combined first + last name
  primaryEmailAddress: {
    emailAddress: string;   // Your email
  };
}
Profile data is read-only in the Quest Hunter app. To update your profile information, modify it in your Google account settings. Changes will automatically sync to Quest Hunter.

​
Profile Implementation

The Profile screen uses Clerk’s useUser hook to access your account data: 
import { useUser } from "@clerk/clerk-expo";

const ProfileScreen = () => {
  const { user } = useUser();

  return (
    <Screen className="gap-4">
      <View className="items-center gap-2">
        {user?.imageUrl ? (
          <Image
            source={{ uri: user.imageUrl }}
            style={{ width: 80, height: 80, borderRadius: 40 }}
          />
        ) : null}
        <View className="items-center gap-0.5">
          <Text className="text-xl font-semibold">{user?.fullName}</Text>
          <Text className="text-muted-foreground text-sm">
            {user?.primaryEmailAddress?.emailAddress}
          </Text>
        </View>
      </View>
    </Screen>
  );
};

​
Data Privacy

Your profile information is:
  • Stored securely in Clerk’s authentication system
  • Synchronized to Convex only when needed for quest tracking
  • Never shared with third parties
  • Only visible to you within the app
Your profile photo and email are linked to your quest completions and leaderboard entries (when implemented). Consider this when choosing your authentication account.

​
Future Enhancements

Planned profile features include:
View your overall quest statistics:
  • Total quests completed
  • Total XP earned
  • Locations visited
  • Categories explored
  • Average completion time
Display earned badges and achievements:
  • Category completions (all quests in a category)
  • Difficulty milestones (10/25/50 quests per difficulty)
  • Speed achievements (fastest completions)
  • Exploration badges (unique locations)
Manage app preferences:
  • Notification settings
  • Map display options
  • Privacy controls
  • Account management
  • Sign out functionality
Connect with other quest hunters:
  • Friends list
  • Recent completions feed
  • Shared quests
  • Challenge invitations

Authentication

Learn how Clerk authentication and user sync works

User Progress

Track your quest completions and XP

Leaderboard

Compare your stats with other users

User API

Technical documentation for user data management

Build docs developers (and LLMs) love

Get started for freeTalk to us