> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notareum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notareum Brand Assets, Logos, and Usage Guidelines

> Download Notareum logos and wordmarks, review the color palette, CSS variables, typography choices, and do/don't brand usage guidelines.

Official Notareum brand assets for integrations, blog posts, conference talks, and product listings. All assets are MIT-licensed matching the rest of the project, subject to the usage guidelines below.

## Download

<Card title="Brand asset repository" icon="download" href="https://github.com/notareum/brand-assets">
  `github.com/notareum/brand-assets` — SVGs, PNGs, color swatches, typography specimens, and templates.
</Card>

Each release contains:

| Folder        | Contents                                       |
| ------------- | ---------------------------------------------- |
| `logo/`       | SVG + PNG at 1×, 2×, 3×                        |
| `wordmark/`   | SVG + PNG at 1×, 2×, 3×                        |
| `palette/`    | Adobe Swatch Exchange (.ase) and CSS variables |
| `typography/` | Font links and specimens                       |
| `templates/`  | Social cards (OG 1200×630), slide templates    |
| `README.md`   | Same guidance as this page                     |

## Logo variants

The Notareum logo exists in two variants:

<CardGroup cols={2}>
  <Card title="Light mode" icon="sun">
    Dark mark on a light background. Use when the background luminance is high (Off White, Slate 50–100).
  </Card>

  <Card title="Dark mode" icon="moon">
    Light mark on a dark background. Use when the background luminance is low (Slate 800–950).
  </Card>
</CardGroup>

Do not render the light-mode logo on a light background or the dark-mode logo on a dark background.

### Wordmark

The wordmark ("Notareum") accompanies the primary mark for longer-form materials. Use headline weight only — do not re-set the wordmark in a different typeface.

### Clearspace and minimum sizes

Maintain clearspace equal to the height of the mark's primary glyph on all sides. Do not place other graphical elements, text, or borders inside the clearspace zone.

| Asset        | Minimum size                         |
| ------------ | ------------------------------------ |
| Primary mark | 24 px or 6 mm (whichever is larger)  |
| Wordmark     | 72 px or 18 mm (whichever is larger) |

## Color palette

The Notareum palette is neutral, high-contrast, and engineered for accessibility.

| Role       | Name      | Hex       | Use                                              |
| ---------- | --------- | --------- | ------------------------------------------------ |
| Primary    | Slate 950 | `#0F172A` | Headlines, primary UI elements, dark backgrounds |
| Accent     | Teal 500  | `#14B8A6` | Links, highlights, verification badges           |
| Background | Off White | `#FAFAFA` | Default light backgrounds                        |
| Muted      | Slate 500 | `#64748B` | Secondary text, borders, disabled states         |

### Accessibility

The palette satisfies WCAG 2.1 AA contrast ratios:

| Foreground | Background | Contrast ratio | Use                               |
| ---------- | ---------- | -------------: | --------------------------------- |
| Slate 950  | Off White  |        16.93:1 | Body text, headings               |
| Off White  | Slate 950  |        16.93:1 | Body text on dark surfaces        |
| Slate 500  | Off White  |         4.53:1 | Secondary text                    |
| Teal 500   | Off White  |         2.83:1 | Non-text UI, large link text only |

<Warning>
  Do not use Teal 500 for body copy on Off White — it fails AA for normal text. Use Slate 950 or Slate 700 for all body text.
</Warning>

### CSS variables

```css theme={null}
:root {
  --nota-primary:    #0f172a;
  --nota-accent:     #14b8a6;
  --nota-background: #fafafa;
  --nota-muted:      #64748b;
}

:root[data-theme="dark"] {
  --nota-primary:    #fafafa;
  --nota-accent:     #14b8a6;
  --nota-background: #0f172a;
  --nota-muted:      #94a3b8;
}
```

## Typography

### Primary typeface — Inter

Used for UI, marketing, and documentation body copy.

* Weights in use: 400 (regular), 500 (medium), 600 (semibold), 700 (bold).
* Italic variants as needed.
* License: SIL Open Font License.
* Download: [rsms.me/inter](https://rsms.me/inter)

### Monospace typeface — JetBrains Mono

Used for code blocks, identifiers, and technical UI.

* Weights in use: 400 (regular), 500 (medium).
* Ligatures disabled in code samples for maximum token fidelity.
* License: SIL Open Font License.
* Download: [jetbrains.com/lp/mono](https://www.jetbrains.com/lp/mono)

### Font stack

```css theme={null}
:root {
  --nota-font-sans: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI",
                    Roboto, sans-serif;
  --nota-font-mono: "JetBrains Mono", "Fira Code", ui-monospace,
                    SFMono-Regular, Menlo, Consolas, monospace;
}
```

## Usage guidelines

### Do

* Use the exact mark and wordmark supplied in the brand repository without modification.
* Maintain clearspace around the mark at all times.
* Pair the logo with the official Notareum palette.
* Use the light-mode logo on light backgrounds and dark-mode on dark backgrounds.
* Refer to the protocol as "the Notareum Protocol" on first mention, then "Notareum" thereafter.
* Describe integrations as "built on Notareum" or "verified by Notareum".

### Don't

* Do not alter the logo — no color changes, outlines, drop shadows, or rotations.
* Do not re-set the wordmark in another typeface.
* Do not combine the Notareum mark with your own logo in a way that implies a formal endorsement or partnership that does not exist.
* Do not place the logo on photographic backgrounds without sufficient contrast treatment.
* Do not use pre-alpha palette values found in early online drafts.
* Do not use the Notareum name for derivative products or forks — rename forks clearly.

### Acceptable usage examples

* "Our wallet integrates the Notareum Protocol for verified address sharing."
* A "Verified by Notareum" badge next to a confirmed resource in your UI.
* A footer link: "Powered by Notareum" routing to these docs.

### Unacceptable usage examples

* "Notareum Premium by \<Your Company>" — combines the name to suggest an official tier.
* Embedding the logo inside your product icon.
* Using the Notareum palette in a competitor's marketing materials.

## File naming convention

Assets in the brand repository follow this naming pattern:

```
logo-light-24.svg
logo-light-24@2x.png
logo-light-24@3x.png
logo-dark-24.svg
wordmark-light-72.svg
social-card-og-1200x630.png
slide-template-16-9.pptx
```

Size tokens (`24`, `72`, `1200x630`) indicate the intended minimum rendering size in pixels.

## Licensing

All brand assets are MIT-licensed. The license text is bundled in `LICENSE` at the brand asset repository root. Attribution is not required by the license but is appreciated.

Inter and JetBrains Mono are licensed under their respective SIL Open Font Licenses. They are not redistributed inside the brand asset repository; use the official upstream sources linked above.

## Press contact

For partnership or press inquiries involving Notareum branding, contact `press@notareum.org`. Ecosystem collaborations, co-marketing, and conference representation are coordinated through that address.