Brand

Everything here is what the product itself uses. The palette and the type scale come from the design frame the landing page is built from; the marks are the files this site serves.

The name

OpenSouk. One word, capital O and capital S, no space and no hyphen. It does not change in running prose, in a headline, or at the start of a sentence, and it is never abbreviated.

Two names are wrong in a way worth stating, because both are still in circulation in older material: the product has never been called Referrer Agent, and referrer-agent is not a product name. That string survives correctly in exactly one place — as the name of an MCP server. referrer-agent and referrer-signer are the two server names, and they stay as they are.

The marks

Two lockups, in three files. All three are SVG with transparent backgrounds — none carries a background plate of its own, so each needs a ground you supply.

Each is served from this site's root, so /logo-opensouk-wordmark-ink.svg fetches the file. This is what they are, each on the ground it is for.

The emblem is a four-pointed star inside a chamfered frame, with the star cut out of the frame rather than drawn on top of it. That cut-out is why the emblem needs a ground behind it: on a background that matches the frame colour, the star disappears.

Use the wordmark wherever there is room for it, and the emblem alone only where there is not — a favicon, an avatar, a tab icon, a dense toolbar. The emblem is not a substitute for the name in prose; the first mention of OpenSouk in any interface should be the word, not the shape.

Pick the wordmark variant by the ground you are placing it on, not by your interface's theme name: ink on anything light, cream on anything dark. Both wordmarks are a single flat colour, so a monochrome context needs no special file. The emblem is blue in the only file there is, and reads on either ground.

Do not recolour either lockup, redraw the emblem, change the spacing between emblem and wordmark, stretch either axis independently, add a shadow or outline, place either over a busy image, or set the wordmark in a typeface of your own. If you need a size the SVG does not suit, scale the SVG.

Colour

Six values. The first two are the ground and the ink; everything else is accent or structure.

Cream and ink swap roles between light and dark rather than each theme having its own palette. That is the whole of the dark mode: the ground becomes ink, the text becomes cream, and blue, orange, clay and line are unchanged.

Four further values are declared for the console illustration alone — #382d2a for the panel's own furniture, #969fff and #f2a444 for its two agents, #32cd32 for a reward line. They are illustration colours rather than tokens, and they should not be reused elsewhere.

Blue is the accent on both grounds: this site sets it as its accent colour once, and does not vary it between light and dark. Clay sits deliberately below body-text contrast on cream, because it is for labels rather than for reading — do not set a paragraph in it.

Type

Two faces, two jobs.

The landing page is Roboto Mono throughout — its design has no second face. This site adds Source Sans 3 for body copy, because documentation is mostly the kind of explanatory sentence a monospace face reads badly at length. Headings, the sidebar, inline code and every label here stay on Roboto Mono, which is what keeps the two properties recognisably the same product.

Both faces are open-licensed and available from Google Fonts, so there is nothing to request. Use Roboto Mono 700 for headings with a slightly negative letter-spacing — this site sets -0.01em.

The landing page's type scale is 16px multiplied by 1.2 for each step, kept unrounded so text metrics match the design: 13.33, 16, 19.2, 23.04, 33.18, 39.81, 47.78.

Naming what the protocol does

Six terms are fixed, and the words in the second column are the ones already in circulation that should not be used for them. Getting these right matters more than getting the colours right: a reader who follows a link expects the page to use the word the link used.

Review Rank and Product Rank are two different measures of two different things, and both are always written with both words. Ranks has what each one is; the Glossary has the rest of the vocabulary.

Using the marks in your own product

You may use the name and the marks to say, accurately, that your product works with OpenSouk. A merchant listing that names the protocol, an agent's tool description, a "works with" row on a pricing page, a talk slide, an article — none of that needs permission.

What is not permitted is anything that reads as more than a factual statement of interoperation:

• Presenting the mark as your own, or as part of your own lockup.
• Any wording or layout that implies OpenSouk built, endorses, certifies, audits or sponsors your product.
• Using the mark as the primary identifier of your product, application icon, or domain.
• A domain, package name, social handle or organisation name containing "OpenSouk".
• Putting either mark on merchandise.

The test to apply: a reader glancing at your page should come away knowing your product works with OpenSouk, and never that it is OpenSouk or is approved by it.

Where these values come from

The palette and the type scale are extracted from the landing page's own design frame rather than transcribed: the usage-ranked colour inventory and the type scale live in the opensouk-landing repository under design/tokens/, and the values above are the ones that recur. The frame also contains several hundred colours internal to the hero illustration, which are not tokens and are not listed here.

The marks are the files this site serves, so what you download is byte-identical to what renders in the header above. Both repositories are under github.com/OpenSoukAI.

Next steps

• Glossary — every protocol term, defined once
• Ranks — what Review Rank and Product Rank each measure
• Overview — what to say OpenSouk does, in the protocol's own words