> **PromptEye Brand Book & Design Language** · Dla agentów AI · PL (wersja źródłowa) · stan 28.10.2026
> Strona dla ludzi: https://brand.prompteye.com/pl/dla-agentow-ai/ · English: https://brand.prompteye.com/en/for-ai-agents.md · indeks dla agentów: https://brand.prompteye.com/llms.txt
> Ścieżki plików są względne wobec https://brand.prompteye.com/ds/ (np. `tokens/colors.css` → https://brand.prompteye.com/ds/tokens/colors.css), odwołania do `*.md` wobec https://brand.prompteye.com/ds/docs/. Poza Claude Design zamiast `_ds_bundle.js` wczytaj `styles.css` i skrypty `js/pe-light.js`, `js/pe-pl.js`, `js/pe-raster.js`, `js/pe-motyw.js` (w tej kolejności).

# PromptEye Brand Book & Design Language (identity v2)

State: 28.10.2026. Always-current online version: https://brand.prompteye.com/llms.txt. Brand Book & Design Language for people: https://brand.prompteye.com/en/ (English), https://brand.prompteye.com/pl/ (Polish).

This folder mirrors https://brand.prompteye.com/ds/. Relative paths below resolve against this folder offline, or against https://brand.prompteye.com/ds/ online.

## Language

The documentation in `docs/` is written in Polish and is the source of truth. English translations of every file are in `docs/en/`. Where a translation differs from the Polish file, the Polish file wins. Write the user's material in the user's language. Class names, attributes and tokens are Polish words (`--pe-kobalt`, `data-pe-hero`, `.dot`): use them exactly as written.

## Read in this order

1. `docs/00-start.md`: principles, priority of sources, file map.
2. `docs/formaty.md`: what you are building → which blocks, with ready HTML skeletons per format.
3. The block you use: `marka.md` (idea, messaging, vocabulary), `logo.md`, `kolor.md`, `typografia.md`, `uklad.md` (layout, table of formats), `tla.md` (backgrounds), `motyw.md` (dot motif), `komponenty.md`, `dane.md` (tables, charts, data colours, AI model icons, partner reports), `raporty.md` (report anatomy, preliminary).
4. `docs/kontrola.md`: checklist before you deliver.

`guidelines/*.html` are 1:1 reference sheets. Copy blocks from them (for example `#t3`, `#w3` in `guidelines/dane.html`) and replace the content.

## Loading in HTML

The docs mention `_ds_bundle.js`. That file exists only inside Claude Design. Everywhere else load:

```html
<link rel="stylesheet" href="styles.css">
<script src="js/pe-light.js"></script>
<script src="js/pe-pl.js"></script>
<script src="js/pe-raster.js"></script>
<script src="js/pe-motyw.js"></script>
<!-- only if you use <image-slot>: <script src="image-slot.js"></script> -->
```

Hosted alternative: `https://brand.prompteye.com/ds/styles.css` and `https://brand.prompteye.com/ds/js/…` in the same order. The React `Logo` component mentioned in `docs/logo.md` also exists only in Claude Design. Use the SVG files from `assets/logo/svg/`.

## Rules you never break

- The motif is added with an attribute (`data-pe-hero`, `data-pe-cta`, `data-pe-komentarze`, `data-pe-rycina`) and the text column is marked with `data-pe-tekst`. The script draws the motif, never you: no dots, raster, map or point in SVG, CSS or your own canvas.
- Orange (#FD723A) is the exception, not decoration. The dot after a headline (`.dot`) never appears in a frame with the motif point. Next to the `b1a` button there is no headline dot and no points in neighbouring buttons. In data only the leader is orange. Orange is never text or background.
- The headline dot (`.dot`) goes only after a slogan headline. Never after every heading, page title or chapter title, never after a question.
- `b1a` (orange) closes an article or a page, only on black. Never in navigation, also not in the light hero F: there the navigation button is `b1b`.
- Colours only from `--pe-*` tokens (`tokens/colors.css`, `tokens.json`). Gradients only from `js/pe-light.js` (with grain), never a CSS gradient.
- Choose the gradient from the table "Jak dobrać i ustawić gradient" in `docs/tla.md`. A hero, cover or page header without the motif uses G5 as an arc, stretched like the hero D light. The transition covers at least half of the frame: never squeeze a gradient into a strip under the text. Make room for text by enlarging the frame, not by shortening the gradient. Light and dark site themes use the same header and gradient.
- The dot grid goes only on a solid background, never together with the motif.
- Data (tables, charts) is always linear, without motif dots. AI model icons come from the sprite `assets/llm/sprite.svg`, pasted once into the page (without it `<use href="#llm-…">` draws nothing). Data colours come from the classes in `css/dane.css`, never typed in by hand.
- A report chapter title is a name, not a slogan: no headline dot.
- Fonts: Geist (headlines, numbers) and Inter (text, data). No third typeface. E-mail is the exception: Arial.
- Messaging follows `docs/marka.md`: "AI recommends your brand" (not "visibility"), the effect rather than the activity, only confirmed numbers.

## Export and screenshots

Add `data-pe-static` to the section and `await window.PEmotyw.ready`. A black frame without dots means the motif has not started: call `PEmotyw.init(document)`, never draw it yourself.

## Formats without a browser (DOCX, PPTX, Google Docs and Slides, Canva)

The motif and grain gradients are drawn by JavaScript and cannot be rebuilt in Office tools. There use the colour tokens, Geist and Inter, the logo files, solid black or white backgrounds and the type sizes from `docs/uklad.md`. Do not imitate the motif or the gradients with shapes or pictures.

## Logo files

SVG is the preferred format; PNG only where SVG is not accepted.

| File | Use |
|---|---|
| `assets/logo/svg/prompteye-logo-color-on-light.svg` | colour logo on white and light backgrounds |
| `assets/logo/svg/prompteye-logo-color-on-dark.svg` | colour logo on black, gradient, photo |
| `assets/logo/svg/prompteye-logo-black.svg`, `prompteye-logo-white.svg` | one-colour uses |
| `assets/logo/svg/prompteye-mark-color.svg`, `-black.svg`, `-white.svg` | mark only: avatar, favicon, very small spaces |
| `assets/logo/png/<name>-<width>.png` | the same files as PNG, transparent background |

Minimum height 14 px. Clear space equals the height of the mark on every side. Placement and size per format: `docs/logo.md` and `docs/uklad.md`.

## Not part of the system yet

Items marked "do rozwoju przy stronie www" (to be developed with the website): mobile versions, home page, looping animation, objects other than the map of Poland, React components other than Logo. Ask before using them.

The report anatomy (`docs/raporty.md`) is a preliminary guideline: the first full report is still being styled. Tables, charts, colours and type rules apply in full; ask before building a whole report from the anatomy.