Vanity URLs — bRRAIn Docs

Build a one-page bRRAIn ID landing site at asid.brrain.io/{your-slug}.

Vanity URLs

A vanity URL is your branded one-page site at asid.brrain.io/{your-slug} — connected to your verified bRRAIn ID. The slug is yours; the bRRAIn ID stays prominently visible across the top of the page so visitors can verify they're at the real you.

Why have one

A vanity page is your verified identity in one shareable URL. Useful for:

  • Email signature.
  • Conference speaker bio.
  • "About" link on artifacts you share publicly.
  • Resume header.
  • Anywhere "here's who I am" needs to be answered with a verified credential.

What's on the page

Every template renders the same skeleton sections:

  • Brain-ID bar — bright, full-width, sticky at the top. Color preset is your pick (see Identity below).
  • Hero — optional logo, company / display name, tagline, optional primary CTA.
  • About — markdown body, sanitized.
  • Services — 1–6 cards.
  • Team — up to 8 optional cards.
  • Contact — email, optional website, optional social links.
  • Footer — provenance line: "built with bRRAIn · bRRAIn ID …".

Templates

Five built-in templates:

  • T1 Minimalist — Inter, single column, neutral grays, services as 2-col list.
  • T2 Bold Corporate — Source Serif, navy + accent, 3-up service cards.
  • T3 Creative Agency — Geist + Space Grotesk, full-bleed gradient hero, masonry tiles, overlapping team circles.
  • T4 Tech Founder — JetBrains Mono, dark background, brain-ID bar rendered as a blinking shell prompt, services as code blocks.
  • T5 Consultancy — Charter long-form, methodology as numbered steps, principals instead of "team".

Brain-ID color preset

The brain-ID bar must always stand out. Pick one preset:

neon-yellow · electric-cyan · magenta-burst · lime-pop · sunset-orange

Foreground color is auto-picked for WCAG-AA contrast.

Building your page

Open https://asid.brrain.io/vanity-builder while signed in. The five-step wizard walks you through:

  1. Slug + template — slug is live-validated against reserved words, the banned list, and existing claims.
  2. Identity — company name, tagline, brain-ID color preset.
  3. Content — markdown about block + 1–6 services.
  4. Team + contact — optional team cards, contact email, website, social profiles.
  5. Preview + publish — JSON envelope preview, then publish.

Progress is saved to your browser between steps; refresh-safe.

Slug rules

  • 3–32 characters, lowercase letters / digits / internal hyphens.
  • No consecutive hyphens; must start and end alphanumeric.
  • Reserved + admin-banned slugs are rejected with a clear reason.
  • Slugs that look like a bRRAIn ID (4 hex + hyphen) are reserved.
  • Owners may rename once per 30 days; the old slug serves a permanent 301.

Optional. PNG / JPG / SVG / WebP up to 512 KB. Uploaded via the wizard; stored in your org's branding vault on console.brrain.io (same logo can power other org chrome surfaces).

Status + admin moderation

Every published site has one of four statuses:

  • active — public, indexable (unless robots_index=false).
  • suspended — admin paused; URL returns HTTP 410 Gone.
  • banned — terminal admin take-down; URL returns 410 + slug enters the unreclaimable list.
  • draft — not yet published; URL returns 404.

Admins moderate at admin.brrain.io/vanity. Suspending or banning writes an admin_audit_log entry.

SEO

Vanity pages are SEO-friendly:

  • Rendered server-side.
  • Open Graph metadata + canonical URL.
  • Optionally indexable — toggle robots_index in the form.
  • Outbound links carry rel="ugc nofollow noopener".

API

POST /api/registry/vanity                     # create
PUT  /api/registry/vanity/{slug}              # update
POST /api/registry/vanity/reserve             # 10-min hold
GET  /api/registry/vanity/check?slug=…        # availability preflight
POST /api/registry/vanity/logo?site_id=…      # multipart logo upload

All write endpoints require a signed-in session that owns the brain ID.

Where to next