Skip to content
inkStar Docs

Profile Pictures

Each employee can have a custom profile picture used throughout inkStar.

Profile picture priority

Section titled “Profile picture priority”

The system uses the first available source:

  1. Custom uploaded photo — The employee’s own S3-hosted profile picture
  2. Linked user’s photo — If linked to a user account, their Clerk profile picture
  3. Initials avatar — Generated from the employee’s name with their assigned color

Uploading

Section titled “Uploading”
  1. Tap the profile picture on the employee detail page
  2. Choose Gallery or Camera
  3. Crop the image
  4. Upload

Profile picture upload requires an internet connection.

Offline caching

Section titled “Offline caching”

Profile pictures are cached locally in Hive:

  • Primary image cached under employeeId
  • Fallback (user photo) cached under {employeeId}_fallback

This ensures profile pictures display correctly when offline.