Identity.
Positioning and visual identity for Evalgist. Voice and the content guide live on the Voice page. Values come from @evalgist/content-style and @evalgist/design-system.
Evidence, not verdicts.
The brand promise. Every external surface stays beneath this ceiling.
Three load-bearing clauses. A batch against one criteria set: resumes, exam answers, transcriptions, each held to the same standard — not arbitrary conversation. Faster, more consistently, with evidence: what the reviewer gets out of the batch. Substantiation, not conclusions: the product ceiling is set deliberately below "the AI decides."
Professionals reviewing a batch.
Professionals evaluating a batch of documents against one criteria set.
Evalgist is the brand. Products take suffixes.
Never sub-brands with independent identity. Outside the auth boundary, first mention uses the full name and second mention may shorten to the suffix. Inside the product, the sidebar lockup is the first mention.
Portfolio: Evalgist Shortlist · Evalgist Grade · Evalgist Extract.
Eight cells of ink. One cell of tone.
No outline, no frame, no highlight. The absence is a quiet member of the field, not a UI state.
The sizes it will actually be seen at.
Above 24 px the tonal cell renders at slate-300. Below 24 px it lifts automatically to slate-400 so the cell stays legible.
Mark, wordmark, and their agreed proportions.
Geist Sans 600. Primary wordmark ≈ 0.78× mark size; product suffix 10 px uppercase with 0.15em tracking, stacked beneath. Gap between mark and wordmark is optical.
Specification.
Mirrors packages/design-system/BRAND.md, which wins on conflict.
The component handles size- and surface-aware logic.
Never manually select between mark variants or hard-code lockup proportions. Import the primitive.
// Product UI — inherits color; wrap in text-slate-700 inside chrome
import { EvalgistMark } from "@evalgist/design-system/brand";
<EvalgistMark size={20} />
// Dark surface — any inverted region. Product chrome is light.
<EvalgistMark size={24} inverted />
// Hero, press, lockup tile — brand tone
import { EvalgistLockup } from "@evalgist/design-system/brand";
<EvalgistLockup markSize={32} />
// Auth screens — parent lockup only, never a product lockup
<EvalgistLockup markSize={32} tone="chrome" />
// Product sidebar and topbar — Shortlist, Grade, Extract
import { EvalgistProductLockup } from "@evalgist/design-system/brand";
<EvalgistProductLockup product="Shortlist" markSize={24} tone="chrome" />
// Tight context — product mobile-nav sheet
import { EvalgistWordmark } from "@evalgist/design-system/brand";
<EvalgistWordmark size={15} product="Shortlist" tone="chrome" />// Product apps — place the icon at app/icon.png (or app/icon.svg).
// Next.js wires it through the file convention.
// app/layout.tsx
export const viewport = { themeColor: "#ffffff" };
// apps/docs is the exception: it serves the favicon set from Downloads,
// a /site.webmanifest, and themeColor "#0f172a".Constraints that protect the reading.
Rules first; then visual examples of violations.
Mark violations
One accent. Brand, never state.
Editorial Plum — oklch(0.39 0.105 325) · #602e63 · 10.1:1 on white. Selected 2026-07-07 against one test: it must never read as a fourth confidence band.
Where it may appear, by surface tier: brand — lockup-adjacent furniture, OG cards, press layouts, but never inside the mark. Marketing — eyebrow dots, links, article and blockquote rules, illustration highlights. Product chrome — none; links and nav use foreground and muted tokens. Buttons stay near-black, band pills keep their semantic hues, and the focus ring stays neutral.
Evidence Editorial. Evaluation made inspectable, not mysterious.
Illustration and generated imagery extend the design system — they do not start a second brand. Synthetic documents, evaluation grids, quote evidence, and slate composition. The full agent-readable contract lives in packages/design-system/IMAGE_STYLE.md.
The formula
Synthetic documents + evaluation grids + highlighted quote evidence + restrained product UI + slate editorial composition. Every image centers a source artifact. The human remains the decider; imagery shows the substantiation, never an AI verdict.
Synthetic composites
Built from owned shapes — no stock, no capturesHero composite: a document fragment, a criteria matrix banded by confidence, and a quote card. All data synthetic; bands carry the only color.
Spot diagram: source to human decision in four nodes.
OG card: one artifact, heading added in code — never generated. Rendered live from /api/og.
Image families
Synthetic documents, an evaluation matrix, quote cards, and bands as one product-led scene. Negative space holds the headline.
One large analytical artifact — criteria chart, band distribution, evidence trail — as the image for a guide or post.
A short flow: document, criterion, evidence quote, human decision. Used inline in body copy.
A restrained slice of real product UI, recomposed through Evalgist tokens with synthetic data.
One strong evidence artifact, 1200×630, with a short heading added in code — never generated.
Token-to-image mapping
Prompt anatomy
Copy-ready base clauseAdd a surface line per family (hero, publication, spot, OG) and the negative-prompt list. Full templates in IMAGE_STYLE.md.
Open Graph examples
Rendered at preview scale; generated at 1200 x 630Imagery contract
- Use the ambient grid as the recognisable field.
- Keep text regions protected and quiet.
- Show evidence paths, document surfaces, or product UI when the image needs substance.
- Avoid stock photography, decorative gradients, mascot illustration, and standalone logo cards.
Open Graph reference
- Canonical size
- 1200 x 630 px
- Runtime generator
- apps/www/app/api/og/route.tsx
- Metadata helper
- apps/www/lib/social-metadata.ts
- Production URL
- https://evalgist.ai/api/og?eyebrow=...&title=...&description=...
- Static fallback
- apps/www/public/og-image.png
Evalgist default card
grid, document stack, evidence card, human reviewEvalgist Shortlist
same artifact, product lockup plus its own headlineApproved, rejected
Mobbin references
Composition cues — cited, not bundledThese captures informed the direction. They are references only — never committed as Evalgist assets. Each notes what to borrow and what to leave behind.
Source files for non-React contexts.
In product code, always use the React components. These files are for slide decks, email signatures, partner decks, press.