Custom domain

Set up your personalized username for a custom wrkks.site URL

Your custom domain on Wrkks takes the form wrkks.site/username, where you choose the username. This creates a memorable, professional URL for your personal website.

Username requirements

When selecting your username:

• Choose a unique identifier (availability is checked automatically)
• Use a professional handle that represents you
• Consider using your name, initials, or professional brand
• Keep it simple and easy to remember

Your username becomes part of your public URL, so choose carefully. You can change it later if needed.

Setting up your username

Your username is displayed and managed from the /website page.

Username display

At the top of your website page, you’ll see:

wrkks.site / [your-username]

The DomainInputField component shows:

• A link icon to indicate this is a URL
• “wrkks.site /” prefix
• Your current username (or placeholder if not set)
• Edit button (pen icon) to change username

Changing your username

1. Click the edit button

   Click the pen icon next to your username. This opens the EditDomainDialog component.

2. Review current username

   The dialog displays:

   • Title: “Change Userhandle”
   • Your current username in a disabled input field
   • Label: “Old Userhandle”
3. Enter new username

   In the “Choose new Userhandle” field:

   • Type your desired username
   • The placeholder shows “New [current-username]”
   • Input validates in real-time
4. Save changes

   Click the Save button. The system:

   • Validates username availability
   • Updates your username via updateUser() function
   • Shows success toast: “Username updated successfully!”
   • Refreshes the page to display new username

Dialog actions

The EditDomainDialog provides two buttons:

• Cancel: Close dialog without making changes
• Save: Submit new username (triggers validation and update)

Username validation

When you attempt to save a new username:

If validation fails, you’ll see an error toast with the specific issue:

• Username already taken
• Invalid characters
• Username too short/long
• Other validation errors

Success confirmation

After successfully updating your username:

1. Success toast appears: “Username updated successfully!”
2. Page refreshes automatically to show the new username
3. URL updates to reflect new username
4. Published site (if live) is immediately accessible at new URL

If your site is already published, changing your username updates your public URL immediately. Share the new link with your audience.

Username in publish flow

Your username is required before publishing:

• The publish button uses your username to determine the public URL
• If username is not set, publishing may fail
• Set your username before your first publish

Technical implementation

The username system:

1. Stores username in user data table (Supabase)
2. Uses updateUser({ username: newUsername }) to save changes
3. Validates uniqueness server-side
4. Associates username with your user account

Best practices

Professional username tips

• Use your name: “john-smith” or “jsmith”
• Keep it short: Easier to share and remember
• Avoid numbers: Unless they’re part of your brand
• Match other profiles: Use the same handle as LinkedIn/Twitter for consistency
• Test pronunciation: Make sure it’s easy to say out loud

Changing username after publishing

If you change your username while your site is live:

1. Old URL (wrkks.site/old-username) stops working immediately
2. New URL (wrkks.site/new-username) becomes active
3. Update any links you’ve shared (social media, resumes, email signatures)
4. No need to republish—the change is instant

Changing your username breaks existing links. Consider the impact before changing if you’ve already shared your URL widely.

URL format

Your complete website URL follows this pattern:

https://wrkks.site/username

Where:

• wrkks.site is the platform domain
• username is your custom handle

Error scenarios

Empty username

If you try to save without entering a username:

• Save action is blocked
• No API call is made
• Dialog remains open

Duplicate username

If your chosen username is taken:

• Error toast appears with message
• Dialog remains open for you to try another
• Current username remains unchanged

Network error

If update fails due to connectivity:

• Error toast shows: “[error message]”
• Try again when connection is restored

Next steps

After setting up your username:

• Publish your website to make it live
• Share your custom URL on professional networks
• Update your resume and business cards with your new link