---
name: link-button-usage
description: >
Use after component-usage-ux when navigation should look like a Button using
@techsio/ui-kit LinkButton, including framework link adapters, href, disabled
state, icons, and Button-compatible variants/themes/sizes.
metadata:
component_version: "2.0.0"
type: "core"
library: "@techsio/ui-kit"
library_version: "0.3.2"
requires: "component-usage-ux framework-consumer-integration app-token-overrides ux-guidelines"
resources: "references/ux.md ../../references/component-contracts.md ../../references/consumer_app_usage_rules.md"
sources: ""
contributor_sources: "libs/ui/src/atoms/link-button.tsx libs/ui/src/atoms/link.tsx libs/ui/src/atoms/button.tsx libs/ui/src/tokens/components/atoms/_button.css libs/ui/src/atoms/link-button.figma.ts"
audience: "consumer"
---
> Portable scope: Use the installed package's exported types and bundled sibling skills. Repository source paths are optional contributor evidence, not consumer prerequisites; use the consuming app's own checks. Resolve ../../references/ paths from this skill's folder, not the app working directory.
# @techsio/ui-kit LinkButton Usage
Use LinkButton for navigation that needs Button styling. Use Button for
actions that stay in the current page state.
## UX/UI guidelines
House rules come from the `ux-guidelines` skill (writing, formatting, states,
where actions and feedback live). This section applies them to `LinkButton`.
**Use it when**
- Navigation that must look like a button: `Go to checkout`, `View order`, CTA on marketing pages, `Back to list` when it is a real URL.
**Use something else when**
| Need | Use instead |
| --- | --- |
| An action that stays on the page | Button |
| A link inside text or lists | Link |
**Do**
- Label with the destination or intent (`View order`, `Continue shopping`).
- Follow Button hierarchy: one primary per surface.
- Use the framework link adapter so client routing and prefetch work.
**Don't**
- Use LinkButton to submit forms or trigger mutations.
- Open new tabs without saying so (`opens in a new tab`).
**Copy and states**
- No `Click here` / `Learn more` without context; `Read the returns policy` instead.
**Behaviour (from the UX spec)**
- A LinkButton to a "New …" page only navigates; the record is created by the form's submit Button.
- `primary` marks the likely next page, not an approved or required step. Never label it `Confirm` or `Save`.
- Disabled must block the real navigation, not just look grey; the kit does this (no `href`, `aria-disabled`, out of the tab order).
**Figma → code**
| Figma | Code |
| --- | --- |
| `severity`, `appearance`, `size` | `severity`, `appearance`, `size` |
| `state=disabled` | `disabled` |
| `state=hover` | not a prop (browser state) |
Full UX page (anatomy, states, behaviour, edge cases): [references/ux.md](references/ux.md). The same page renders in Storybook as *Atoms/LinkButton → UX guidelines*.
## Setup
```tsx
import NextLink from "next/link"
import { LinkButton } from "@techsio/ui-kit/atoms/link-button"
Products
```
Supported LinkButton-specific props:
```text
as: React element type
href: string
disabled: boolean
variant/theme/size/block/uppercase: Button visual props
icon/iconPosition/iconSize: Button icon props
```
## Core Patterns
### Use for navigational CTA
```tsx
Checkout
```
If clicking submits, deletes, saves, opens a dialog, or mutates state, use
Button instead.
### Use framework adapters directly
```tsx
Orders
```
Do not create a local wrapper until `framework-consumer-integration` proves the
component cannot accept the framework prop shape.
### Reuse Button visual semantics
```text
severity="danger" -> destructive navigation such as leave/cancel flow
appearance="ghost" -> low-emphasis navigation action
size="current" -> inherit size from parent surface
```
The visual props come from Button variants and tokens.
## Common Mistakes
### HIGH Button used for route navigation
Wrong:
```tsx
```
Correct:
```tsx
Products
```
Source: libs/ui/src/atoms/link-button.tsx
### HIGH Native anchor styled like a button
Wrong:
```tsx
Checkout
```
Correct:
```tsx
Checkout
```
Source: libs/ui/src/tokens/components/atoms/_button.css
### HIGH Hallucinated button prop
Wrong:
```tsx
Help
```
Correct:
```tsx
Help
```
Source: libs/ui/src/atoms/button.tsx
### MEDIUM Wrapper before adapter check
Wrong:
```tsx
function AppLinkButton(props: Props) {
return
}
```
Correct:
```tsx
Profile
```
## Validation Commands
```sh
rg -n "