# Source Sans font

Source Sans 3, self-hosted (OFL-1.1), as an alternative to Inter. Import styles/candor-font-source-sans.css after candor.css; it points --cd-font at it.

- Registry name: `font-source-sans` (`@candor/font-source-sans`)
- Tier: Free (MIT). No licence key needed.
- Docs: https://candor.themethodic.com/docs/font-source-sans

## Install

```bash
npx candor-ui add font-source-sans
```

Run `npx candor-ui@latest init` once first (https://candor.themethodic.com/get-started.md). Without the CLI: `npx shadcn@latest add @candor/font-source-sans`.
npm packages: @fontsource-variable/source-sans-3@^5.3.1.

## Example

```tsx
"use client"

import "@fontsource-variable/source-sans-3/wght.css"

// In your app, import styles/candor-font-source-sans.css after candor.css instead: it loads this and sets --cd-font.
const family = '"Source Sans 3 Variable", system-ui, sans-serif'

export default function Example() {
  return (
    <div className="max-w-lg space-y-1" style={{ fontFamily: family }}>
      <p className="text-lg" style={{ fontWeight: 620 }}>
        Source Sans 3 in Candor
      </p>
      <p className="text-sm">The agent read 14 records and changed 3. Nothing was sent.</p>
      <p className="text-sm tabular-nums" style={{ fontWeight: 400 }}>
        0123456789 · $1,204.50 · 12 Mar 2026
      </p>
    </div>
  )
}
```

## Rules for using Candor UI

- Components take plain typed data. Never pass model output as HTML or render it as a link; messages are typed blocks.
- A control that can't be used says why: wrap it in `<Locked reason="…">`, don't just disable it.
- Don't show a value you don't have: leave it out (it renders as —) rather than guess. An estimate is labelled as one.
- Nothing is pre-selected in a decision a person makes, and the agent is named from your app's data, never from model output.
- Your app's words go in `LocaleProvider`: its fixed strings in `strings`, its nouns in `nouns`; entity kinds and agent roles in `EntityKindsProvider` and `AgentRolesProvider`.
