Link

An anchor with an automatic external-link cue and accessible new-tab semantics.

Group: Primitives · Import path: @orionshub/lucent/link · Server-safe — renders on the server without a client bundle.

Import

tsx

import { Link } from '@orionshub/lucent'
import '@orionshub/lucent/styles.css' // once, at your app root

Examples

Internal & external

Show source

tsx

export function LinkBasic() {
  return (
    <Text>
      An <Link href="#internal">internal link</Link> and an{' '}
      <Link href="https://example.com" target="_blank">external link</Link> with a new-tab cue.
    </Text>
  )
}

Props

Prop	Type	Default	Description
`asChild`	`boolean \| undefined`	—	Render the single child element instead of an <a> (via Slot).
`external`	`boolean \| undefined`	—	Force external-link treatment (cue + safe rel). Also inferred from target="_blank".

Guidance

One-time CSS import

Import the compiled stylesheet once at your app root: import '@orionshub/lucent/styles.css'. Components ship stable class names and read design tokens from CSS custom properties — there is no style runtime. See CSS Import.

Transparency & solid mode

Every glass surface reads --lucent-glass-opacity (0.60–1.0). Dial it at runtime with setGlassOpacity(), or switch to setContrast('solid') for a fully opaque, high-contrast rendering. See Transparency & Solid Mode.

RTL

Authored with CSS logical properties — set dir="rtl" on a parent (or the document) and layout mirrors with no JS. Toggle RTL from the glass-controls panel to preview. See RTL Support.

SSR / Next.js

Server-safe — renders on the server without a client bundle. All components are safe to import in a Server Component tree; interactive ones carry their own "use client" boundary. See SSR & Next.js.

Link ​

Import ​

Examples ​

Internal & external ​

Props ​

Guidance ​