Public Profiles

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ephraimduncan/minimal.so/llms.txt

Use this file to discover all available pages before exploring further.

​

Setting Up Your Profile

​

Username

1. Open Settings (click your avatar → Settings)
2. Go to the “Public Profile” tab
3. Enter a username (lowercase letters, numbers, and hyphens only)
4. Wait for availability check (green checkmark = available)
5. Click “Save”

​

Username Validation

const usernameSchema = z.string()
  .min(3, "Username must be at least 3 characters")
  .max(20, "Username must be at most 20 characters")
  .regex(/^[a-z0-9-]+$/, "Username can only contain lowercase letters, numbers, and hyphens");

​

Real-time Availability

• Checking: Gray spinner while validating
• Available: Green checkmark - username is yours!
• Taken: Red X - try another one
• Invalid: Red X with error message

​

Profile Visibility

1. In Settings → Public Profile
2. Toggle “Public Profile” switch
3. When enabled, your profile is accessible at /u/username
4. When disabled, the profile page shows a 404 error

​

Profile Information

​

Bio

• Up to 160 characters
• Appears below your name on your profile
• Great for a tagline or description

​

Social Links

• GitHub: Your GitHub username (without @)
• Twitter/X: Your Twitter handle (without @)
• Website: Any URL (https:// is added automatically)

​

Profile Picture

• The avatar you upload in Settings → General
• Or your initials if no avatar is uploaded
• Avatar also appears in the dashboard header

​

Making Content Public

​

Public Groups

1. Click the group selector dropdown
2. Select “Make Public” for the current group
3. Confirm the action
4. All bookmarks in the group become visible on your profile

​

Public Bookmarks

​

In a Private Group

• Right-click a bookmark → “Make Public”
• The bookmark appears on your profile
• Globe icon appears next to the bookmark

​

In a Public Group

• All bookmarks are public by default
• Right-click → “Make Private” to hide specific ones
• Hidden bookmarks won’t appear on your profile

​

Visibility Hierarchy

Group: Public
  Bookmark A: (default) → Public ✓
  Bookmark B: isPublic = false → Private ✗
  Bookmark C: isPublic = true → Public ✓

Group: Private
  Bookmark D: (default) → Private ✗
  Bookmark E: isPublic = true → Public ✓
  Bookmark F: isPublic = false → Private ✗

​

Bulk Visibility Controls

1. Enter selection mode (right-click → “Select Multiple”)
2. Select the bookmarks you want to change
3. In the toolbar, click:
   • Make Public: Makes all selected bookmarks visible
   • Make Private: Hides all selected bookmarks

​

Profile Features

​

Profile Actions

• Copy Profile Link: Copy your profile URL to clipboard
• Preview Profile: Open your profile in a new tab

​

Profile Display

1. Header:
   • Profile picture
   • Name
   • Username
   • Bio
   • Social links
2. Groups:
   • Only public groups appear
   • Group name with colored indicator
   • Bookmark count
3. Bookmarks:
   • Public bookmarks from public groups
   • Plus bookmarks marked public in private groups
   • Same visual style as your dashboard
   • Click to open in new tab

​

Privacy & Security

​

What’s Hidden

• Private groups (completely invisible)
• Private bookmarks within public groups
• Your email address
• Account settings
• Any content marked private

​

What’s Public

• Your username and profile URL
• Bio and social links (if set)
• Public groups and their contents
• Individual bookmarks marked public
• Profile picture

​

Changing Your Mind

1. Single bookmark: Right-click → “Make Private”
2. Entire group: Group dropdown → “Make Private”
3. Entire profile: Settings → Toggle “Public Profile” off

​

Use Cases

​

Profile Optimization Tips

​

Profile Settings Reference

​

API Reference

​

Check Username Availability

const { data } = await client.profile.checkUsername({
  username: "john-doe"
});
// Returns: { available: true }

​

Update Profile

await client.profile.update({
  username: "john-doe",
  bio: "Building cool things",
  github: "johndoe",
  twitter: "johndoe",
  website: "https://johndoe.com",
  isProfilePublic: true
});

​

Set Group Visibility

await client.group.setVisibility({
  id: groupId,
  isPublic: true
});

​

Set Bookmark Visibility

await client.bookmark.setVisibility({
  id: bookmarkId,
  isPublic: true // or false or null
});