# Action Link

> A link styled as a button, for actions that go somewhere.

```tsx
import { ActionLink } from '@brand-studio/ui';

export default function ActionLinkDemo() {
  return (
    <div style={{ display: 'flex', flexWrap: 'wrap', gap: 12 }}>
      <ActionLink href="#menu">See the menu</ActionLink>
      <ActionLink href="#visit" tone="secondary">Plan a visit</ActionLink>
    </div>
  );
}
```

## Installation

```sh
npm install @brand-studio/ui
```

React 18 or 19 is a peer dependency. Import the stylesheet once and wrap the app in a brand theme:

```tsx
import '@brand-studio/ui/styles.css';
import { BrandTheme, ActionLink } from '@brand-studio/ui';
import brand from './brand.json';

<BrandTheme palette={brand.tokens} mode="system">
  {/* your app */}
</BrandTheme>
```

## Usage

```tsx
import { ActionLink } from '@brand-studio/ui';
```

```tsx
<ActionLink href="/menu">See the menu</ActionLink>
```

## Accessibility

- Renders an `<a>`. Use it when the action goes to another page; use Button when it changes something here.

## API Reference

| Prop | Type | Default |
|---|---|---|
| `href` | `string` | – |
| `tone?` | `"inverse" \| "primary" \| "secondary"` | `'primary'` |
| `shape?` | `"default" \| "pill"` | `'default'` |

Source: https://brandstudio.js.org/docs/components/action-link/
