# Velari brand guidelines for AI agents

Base URL: https://identity.velari.ae · Updated: 2026-10-17 · Human version: https://identity.velari.ae/

This file holds the rules that apply to every task. Load a topic file only when the task needs it: `GET /AGENTS/<topic>` returns plain Markdown. Asset paths below are relative to the base URL.
Machine-readable tokens and component specs in the DESIGN.md format (google-labs-code/design.md): `GET /DESIGN.md`.
Brand generators (an HTTP API and MCP server for posts, signatures, logo files and diagrams) are not available yet: place the supplied files and follow these rules instead.

## Topics

| Load | When |
| --- | --- |
| `/AGENTS/naming` | Writing the brand name, naming a piece, product copy that mentions a piece, URLs and file names. |
| `/AGENTS/logo` | Placing the wordmark, monogram, emblem or an icon; choosing a logo file; clear space and minimum sizes. |
| `/AGENTS/color` | Choosing any colour for design, UI, print, packaging, social or charts. |
| `/AGENTS/typography` | Setting any English text: fonts, sizes, weights, tracking, line heights. |
| `/AGENTS/tokens` | Writing CSS, SCSS, Tailwind, email templates or any code that needs brand values. |
| `/AGENTS/arabic` | Anything in Arabic or bilingual English/Arabic: copy, tags, web pages, RTL layouts. |
| `/AGENTS/imagery` | Choosing or creating photos, the four-point star, the starfield, star patterns or embroidery renderings. |
| `/AGENTS/layout` | Laying out web pages, posts, letterheads, hang tags; spacing and margins. |
| `/AGENTS/elements` | Using the starfield, star scatter, star rule and bullet, the arch frame, or interface icons. |
| `/AGENTS/voice` | Writing or editing any English copy: captions, WhatsApp replies, web, tags, confirmations. |
| `/AGENTS/digital` | Website, Instagram, WhatsApp and other digital touchpoints. |
| `/AGENTS/email-signatures` | Creating or updating an email signature. |
| `/AGENTS/print` | Hang tags, tissue seals, gift boxes, inserts, print colour specs (CMYK, Pantone). |
| `/AGENTS/stationery` | Business cards, letterhead, envelopes, thank-you and care cards, invoices. |
| `/AGENTS/social-media` | Instagram posts, stories, highlights, profile pictures and captions. |
| `/AGENTS/ui` | Building screens, web pages, components or prototypes for velari.ae. |
| `/AGENTS/diagrams` | Drawing any diagram, flowchart, process or journey figure. |
| `/AGENTS/data-visualization` | Making charts, KPI tiles, dashboards or tables of figures. |
| `/AGENTS/assets` | You need the exact URL or file name of a logo, font, element or download. |

## Who we are

Velari Atelier (velari.ae) is a UAE luxury fabric atelier. It creates premium women's attire, starting with embroidered mukhawara fabrics for women across the UAE, sold as fixed 3 m cuts and priced in AED. Each piece is given a name, never a code, so every fabric arrives with its own story. Values: crafted, unique, named. The spirit comes from Velaris, the City of Starlight: a private world, found by those who know where to look; the four-point star is its light. Voice: poetic, not flowery; warm and personal; assured, never loud. A sanctuary, not a marketplace.

## Always apply

### Names

- Velari Atelier in full, Velari on second mention; never VELARI in running text. Arabic: فيلاري أتيليه.
- The VELARI name in the logo is custom lettering: place the logo file, never type it.
- One masterbrand, no sub-brands. Every piece has a name (e.g. Najma, Layali), capitalised and italic inline; never show stock codes to clients.
- Units and prices: 3 m (with a space), AED 1,450 (AED first, no decimals). URLs lowercase and hyphenated: velari.ae/pieces/najma.

### Visual essentials

- Colours: Deep Plum #420F29 (the voice: logo, headings, signature backgrounds), Warm Ivory #F6F1E9 (the base), Midnight Navy #141B35 (the evening: occasions, gift box), Velvet Mauve #754F66 (emblem ground, secondary panels), Dusty Mauve #936A7E (the swish; small accents only, never small text). Proportion ≈ ivory 46 / plum 30 / navy 12 / dusty 6 / velvet 6. No other colours.
- Contrast: Plum on Ivory 14.02:1 and Ivory on Navy 15.09:1 for everything; Velvet on Ivory 6.09:1 for secondary text; Dusty on Ivory 4.06:1 for large type only.
- Type: Cinzel for headings, labels and buttons (uppercase; tracking .12em titles, .24em labels); Cormorant Garamond for text (Medium 500, 20 px body, italic for emphasis and piece names); Amiri for Arabic.
- Logo: use the supplied files in `/assets/logos/`. Plum on light, ivory on dark. Clear space = the height of the star (X) on every side. Minimums: wordmark 160 px / 35 mm, monogram 48 px / 12 mm, emblem 80 px / 18 mm tall. Never stretch, rotate, recolour, retype, add effects or move the star.
- Marks: the wordmark is the default; monogram for small spaces, seals and social; emblem for hang tags, boxes and invitations; round icons for profiles, highlights and the favicon.
- The four-point star (long axis vertical; never rotated or redrawn) is the signature: one large star per view. The starfield bleeds off one edge of dark layouts, never behind body text.
- Layout: centred, calm, at least half of a layout ivory or open ground; fine plum rules, not boxes; square corners; no shadows, glows or added gradients.

### Voice essentials

- Poetic, not flowery: short sentences, one image per line. Warm and personal: speak to one woman, as at a private appointment. Assured, never loud.
- British English. No exclamation marks; no sale, discount, % off, hurry or urgency language; no ALL CAPS in running text. At most one emoji in social, only ✦ or 🤍.
- Introduce a piece by name, then fabric, cut and price. End with an invitation, not a push: “Tell us the occasion and we'll bring the pieces to you.”
- No stock photography or AI-generated models; never present renders as real fabric.

### Arabic

- Write Arabic as Arabic and have a native editor review it; never machine-translate piece stories.
- Amiri, body 22–24 px, leading 1.8, never letter-spaced. RTL: mirror the layout, never the logo, star, monogram or emblem.
- Eastern Arabic digits in Arabic copy (١٬٤٥٠ د.إ); Western digits in prices on bilingual tags. Both languages get equal size and weight.

## Core tokens

```
--v-color-plum: #420F29   --v-color-ivory: #F6F1E9   --v-color-navy: #141B35
--v-color-velvet-mauve: #754F66   --v-color-dusty-mauve: #936A7E
--v-font-display: "Cinzel","Trajan Pro",Georgia,serif
--v-font-text: "Cormorant Garamond","Cormorant",Garamond,Georgia,serif
--v-font-arabic: "Amiri","Noto Naskh Arabic","Traditional Arabic",serif
--v-size-*: label 12.8 · small 16 · body 20 · lead 25 · h3 31.25 · h2 39.06 · h1 48.83 · display 61.04 (px)
--v-tracking-label: .24em  --v-tracking-title: .12em  --v-leading-body: 1.6
--v-space-*: 4px steps up to 128 (1=4, 2=8, 3=12, 4=16, 5=24, 6=32, 7=48, 8=64, 9=96, 10=128)
--v-radius-0: 0  --v-radius-1: 2px  --v-radius-arch: 999px 999px 0 0
Semantic: --v-surface --v-surface-alt --v-surface-inverse --v-text --v-text-muted --v-text-inverse --v-line --v-accent --v-focus
Full set: /assets/css/tokens.css · /assets/downloads/velari-tokens.json · /AGENTS/tokens
```

## When unsure

Prefer fewer elements, more space, Deep Plum on Warm Ivory, and one star. Rules marked *(proposed)* in the topic files are recommendations that build on the approved guidelines. Ask the Velari brand team before inventing piece names, colours, logos, print values or Arabic terms.