Profile

View and manage your Space7 profile, contribution stats, and account settings.

Your profile captures your identity on Space7 and tracks your contribution history across all Spaces. You can update your display information, change your password, or permanently delete your account from the profile settings screen.

Profile structure

type Profile = {
  user_id: string;
  username: string;
  email: string;
  bio: string;
  profile_picture: string;  // URL to avatar image
  is_verified: boolean;
  created_at: string;
  updated_at: string;
  stats: {
    spaces_created: number;
    spaces_participated: number;
    total_words_contributed: number;
    total_appreciations_received: number;
  };
};

Field	Description
user_id	Immutable unique identifier
username	Public display name shown in Spaces and on messages
email	Account email address (not publicly visible)
bio	Short text about yourself shown on your profile
profile_picture	CDN URL for your avatar image
is_verified	true if your account has been verified
created_at	ISO-8601 timestamp of account creation
updated_at	ISO-8601 timestamp of the last profile change

Contribution stats

The stats object provides a cumulative record of your activity:

Spaces created

The total number of Spaces you have created. Reflects your role as a topic initiator in the community.

Spaces participated

The number of distinct Spaces you have joined and sent at least one message in.

Total words contributed

The sum of word_count across all your messages. Space7 tracks every word you contribute to discussions.

Total appreciations received

The cumulative count of appreciations (👍) received on all your messages across every Space.

Your profile is fetched from GET /api/profile/me (auth required) and includes the latest stats at request time.

Updating your profile

Username

1. Open Profile Actions

   Go to the My Profile tab and tap the yellow menu (hamburger) button in the header. The Profile Actions modal opens.

2. Tap Change Username

   Tap Change Username in the modal. A text input expands inline.

3. Enter a new username

   Type the username you want. Usernames must be unique across all Space7 accounts.

4. Save

   Tap Save Username. The app sends:

   PUT /api/profile/username
   

   // Request body
   { username: string }
   
   // Response
   { message: string }
   

Bio

1. Open Profile Actions

   Go to the My Profile tab and tap the yellow menu (hamburger) button in the header.

2. Tap Change Bio

   Tap Change Bio in the modal. A multiline text input expands inline.

3. Write your bio

   Enter a short description of yourself. This text is visible to other users on your profile.

4. Save

   Tap Save Bio. The app sends:

   PUT /api/profile/bio
   

   // Request body
   { bio: string }
   
   // Response
   { message: string }
   

Profile picture

1. Open Profile Actions

   Go to the My Profile tab and tap the yellow menu (hamburger) button in the header.

2. Tap Change Profile Picture

   Tap Change Profile Picture in the modal. The document picker opens immediately, filtered to image files.

3. Select an image

   Choose an image from your device (5 MB maximum). The default MIME type is image/jpeg; the file is named avatar-{timestamp}.jpg if no name is provided.

4. Upload

   The app uploads the image as multipart/form-data under the field name avatar:

   PUT /api/profile/picture
   

   // Response
   { profile_picture: string }  // New CDN URL for the uploaded avatar
   

   Your avatar updates everywhere it appears — messages, Space headers, and your profile — as soon as the upload completes.

Changing your password

1. Open Profile Actions

   Go to the My Profile tab and tap the yellow menu (hamburger) button in the header.

2. Tap Change Password

   Tap Change Password in the modal. Two password fields expand inline.

3. Enter your current password

   Provide your existing password to confirm your identity.

4. Enter a new password

   Type your new password in the second field.

5. Submit

   Tap Save Password. The app sends:

   PUT /api/profile/password
   

   // Request body
   {
     currentPassword: string;
     newPassword: string;
   }
   
   // Response
   { message: string }
   

If currentPassword does not match the password on record, the request is rejected with an error. You are not locked out, but you must supply the correct current password to proceed.

Deleting your account

1. Open Profile Actions

   Go to the My Profile tab and tap the yellow menu (hamburger) button in the header.

2. Tap Delete Account

   Tap Delete Account (pink button at the bottom of the modal).

3. Confirm

   A native confirmation alert appears: “This permanently deletes your account and all associated data.” Tap Delete to proceed, or Cancel to abort.

4. Account removed

   The app sends:

   DELETE /api/profile/account
   

   // Response
   { message: string }
   

   Your account, messages, and all associated data are permanently deleted.

Account deletion is irreversible. All your messages, Spaces you created, and contribution history are permanently removed. There is no recovery option.