docs: universal usernames page with interactive resolution diagram - #11
Merged
Conversation
Adds overview/make-usernames-universal.mdx — how a product with its own username suffix gives those identities ENS names that any wallet resolves, via either a .eth parent or a DNS domain imported with DNSSEC. The page carries an animated CCIP-Read walkthrough (snippets/flow-explainer.jsx): - Six beats, resolve through signed response, with the payload shown at each hop. - Two toggles that both leave the path unchanged, which is the point: parent name (.eth vs imported DNS) and where records live (onchain contract vs your own API). Step 3 reads one store, never both — the unselected store stays visible but muted so the either/or reads without drawing a path nobody takes. - Arrow controls with a position readout instead of anonymous dots, and a beat-keyed timer so a manual step gets a full beat. Styles live in custom.css since Mintlify strips <style> tags from snippets. Note the comment on .fx: container-type there makes Chrome paint every fill: var(--fx-*) in the SVG black.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two commits that were left on the previous branch after PR #10 merged.
Universal usernames page
New
overview/make-usernames-universal.mdx: a product with its own username suffix can give those identities ENS names any wallet already resolves, without moving its registry to Ethereum. Covers both parent options — register a.ethname, or import a DNS domain you already own with DNSSEC — and states plainly that they resolve identically, so the choice is branding, not mechanics. Examples usehappy.brand/happy.brand.eth/happy.brand.idthroughout.Interactive CCIP-Read diagram
snippets/flow-explainer.jsx, an animated walkthrough of one lookup embedded in that page:resolve()through the signed response, showing the payload at each hop..ethvs imported DNS) and records (onchain contract vs your own API).Layout, palette and type were tuned against the real stylesheet at the actual docs column width: one hue per party with the accent reserved for motion, every group label the same distance above its own box, and the infrastructure box tightened so its padding matches on both sides.
Worth knowing for future snippets
container-typeon the card element makes Chrome resolve everyfill: var(--fx-*)inside the SVG to black — the custom properties still inherit and non-paint properties still apply, so it presents as a rendering bug rather than a cascade one. There is a comment on.fxincustom.cssto stop it being re-added.Styles live in
custom.cssbecause Mintlify strips<style>tags injected from snippets.Also included
9c7f5ce— ENS Components section:developer-guide/sdks/ens-components.mdx, a changelog entry, and the matchingdocs.jsonnav.Checks
tsc --jsx preserve).🤖 Generated with Claude Code
https://claude.ai/code/session_011M5cz2owGrUz9ab9eEVyNg