Publishing

Social media.

Rules for every Evalgist account: channels, templates, voice, and review. Visual rules from PATTERNS.md apply here too.

Guide version v1 · 2026-10-25·Review checklist
01Purpose

One playbook for every account.

The marketing owner maintains this guide. A designer builds templates. A reviewer signs off before anything scheduled goes live. These rules apply to company accounts and to any teammate posting as Evalgist.

Social is distribution, not a separate product surface. When copy or visuals disagree with Shortlist production, Shortlist wins.

02Channels

Match the channel to the job.

Each platform has a primary use. Do not cross-post the same asset without retargeting size and copy.

X

Short product updates, release notes, links to guides, and timely replies. One idea per post.

LinkedIn

Hiring workflow stories, evidence-first positioning, and longer context for committees and HR leaders.

YouTube

Walkthroughs and explainers with captions. Thumbnail carries the promise; the video shows real screens.

Vertical video

Short clips (Shorts and similar). Lead with the workflow problem, then show production Shortlist UI.

Link previews / Open Graph

Any link to evalgist.ai or the docs. Generated cards must match /brand/og-image.png and the runtime /api/og route.

03Content types

Branding follows the content.

Full brand treatment is for announcements. Walkthroughs stay honest. Casual engagement stays light.

How much branding

full · screen · light

Product announcement

Wrong: a meme template with tiny product mention.

Right: full template: mark, headline, OG grid or evidence artifact, brand accent off data panels.

Product walkthrough

Wrong: a staged UI mock with features Shortlist does not ship.

Right: a screen capture from production Shortlist, minimal caption bar, no fake quote highlights in the resume view.

Casual engagement

Wrong: a locked brand frame for a one-line reply.

Right: plain text or a light mark watermark; skip the full template.

04Visual rules

Tokens, real screens, no invented UI.

Social assets use the same tokens as the design system. Brand accent stays on chrome, not on candidate data.

  • Use design tokens and Geist (see @evalgist/design-system and @evalgist/og-kit hex mirrors).
  • Screenshots come from production Shortlist only.
  • Do not invent features (no quote highlight bands in the resume view unless the product ships them).
  • Follow the Visual rules table in PATTERNS.md (selected row, EvidenceQuote, verdict tokens).
  • Never use a rounded card with a colored left border on social crops (that pattern is for selected list rows only).

Official sizes

checked 2026-10-25
FormatCanvasOfficial source (checked 2026-10-25)
Open Graph / link preview1200 × 630https://ogp.me/
The Open Graph protocol does not fix pixel dimensions. Evalgist uses 1200 × 630 via @evalgist/og-kit (same as /brand/og-image.png).
X landscape post (template canvas)1600 × 900 (16:9)https://help.x.com/en/business-and-advertising/creative-ad-specifications
X publishes no pixel size or crop guidance for organic post images. Its only official size guidance is the Standalone Image Ads spec in X creative ad specifications (checked on 2026-10-25): 1200 × 628 for 1.91:1, 1200 × 1200 for 1:1, 16:9 at 1920 × 1080, and 9:16 at 1080 × 1920. PNG or JPEG, max 5 MB. Evalgist keeps this 16:9 template canvas (a ratio X lists as supported at 1920 × 1080).
X link-style image (alternative)1200 × 628 (1.91:1)https://help.x.com/en/business-and-advertising/creative-ad-specifications
X publishes no pixel size or crop guidance for organic post images. Its only official size guidance is the Standalone Image Ads spec in X creative ad specifications (checked on 2026-10-25): 1200 × 628 for 1.91:1, 1200 × 1200 for 1:1, 16:9 at 1920 × 1080, and 9:16 at 1080 × 1920. PNG or JPEG, max 5 MB. Use this size for link-style images when you want the ad-spec 1.91:1 recommendation.
LinkedIn image post (landscape)1200 × 627 (1.91:1)https://www.linkedin.com/help/linkedin/answer/a563309
Recommended ratio for custom images on Page posts.
LinkedIn link preview (sharing module)Minimum 1200 × 627https://www.linkedin.com/help/linkedin/answer/a521928
Applies to og:image pulled into LinkedIn link shares.
Portrait feed image (4:5)1080 × 1350https://www.facebook.com/business/ads-guide/update/image/instagram-feed
Common 4:5 export size for in-feed portrait posts. Meta's Instagram Feed ads guide specifies a 4:5 ratio (1440 x 1800 px); 1080 x 1350 matches that ratio. Use 9:16 only for Stories, Reels, and Shorts covers.
YouTube video thumbnail1280 × 720 (16:9, min width 640 px)https://support.google.com/youtube/answer/72431?hl=en
YouTube also recommends larger 16:9 uploads (up to 3840 × 2160) when available.
Vertical video cover (9:16)1080 × 1920https://support.google.com/youtube/answer/72431?hl=en
Shorts thumbnails use a 9:16 aspect ratio (official examples up to 2160 × 3840). Export at 1080 × 1920 for a standard master.

Safe zones

per format
  • OG 1200 × 630: Keep copy and mark in the left ~62%. Right side stays open for the grid and evidence artifact.
  • X 1600 × 900: 48 px outer margin. Title and mark in the lower third.
  • X 1200 × 628: 48 px margin. One headline and mark; keep evidence UI readable at link-preview scale.
  • LinkedIn 1200 × 627: 48 px margin. Avoid critical copy in the bottom 12% (mobile chrome).
  • Portrait feed 1080 × 1350: 96 px margin. Stack mark, headline, then product screenshot centered.
  • YouTube 1280 × 720: 80 px margin. One short headline (3–5 words); faces and UI left of center.
  • Vertical 1080 × 1920: 96 px top and bottom safe area; stack mark, headline, then product screenshot centered.
05Code templates

Generate assets the same way as OG cards.

Open Graph images use @evalgist/og-kit. Channel sizes use @evalgist/social-kit on the same Geist fonts and token hex. Export PNGs with the package CLI or preview every template at exact pixel size on the docs site.

Template preview (exact pixel sizes)

Where images are implemented

production paths

packages/social-kit (channel templates, render CLI)

packages/og-kit/src/handler.tsx (createOgHandler, OG_IMAGE_SIZE)

packages/og-kit/src/og-illustration.tsx (layout and token hex)

apps/www/app/api/og/route.tsx + apps/www/lib/social-metadata.ts

apps/docs/app/api/og/route.tsx

Static fallback: apps/www/public/og-image.png and apps/docs/public/brand/og-image.png

Template inputs

all formats
  • title (required, plain language)
  • subtitle or description (optional, one line)
  • eyebrow / product name (Evalgist Shortlist on first mention)
  • product screenshot (production Shortlist only)
  • band label (Strong / Review / Low, never a percentage)
  • format key (x-landscape | x-link | linkedin | portrait)

Example

docs snippet only
import { ImageResponse } from "next/og";
import { OG_IMAGE_SIZE, createOgHandler } from "@evalgist/og-kit";

// Production routes today:
// apps/www/app/api/og/route.tsx
// apps/docs/app/api/og/route.tsx
export const GET = createOgHandler({
  eyebrow: "Evalgist Shortlist",
  title: "AI resume screening, with evidence attached.",
  description: "Quoted evidence for every criterion.",
});

// Custom social sizes: reuse the same fonts and token hex from OgIllustration.
// X: 1600 × 900 (16:9 template) or 1200 × 628 (1.91:1 link-style); see /social#visual-rules.
export function renderLandscapeSocial(title: string) {
  return new ImageResponse(
    (
      <div
        style={{
          width: "100%",
          height: "100%",
          display: "flex",
          flexDirection: "column",
          justifyContent: "flex-end",
          padding: 48,
          background: "#f8fafc",
          color: "#0f172a",
          fontFamily: "Geist",
        }}
      >
        <div style={{ fontSize: 20, color: "#64748b" }}>Evalgist Shortlist</div>
        <div style={{ fontSize: 44, fontWeight: 600, letterSpacing: "-0.02em" }}>{title}</div>
      </div>
    ),
    { width: 1600, height: 900 },
  );
}

// OG cards stay on OG_IMAGE_SIZE: { width: 1200, height: 630 }

OG preview

live /api/og
Evalgist Shortlist Open Graph example
06Voice

Same voice, shorter sentences.

Social copy follows packages/content-style (rendered on /brand/voice). It is not a separate tone: tighten cadence, one message per post, and keep evidence language.

Length

Wrong: a thread that restates the whole landing page.

Right: one claim, one proof point, optional link.

Match language

Wrong: posting an 87% match score.

Right: naming a band (Suggested match in product UI; spell out Strong / Review / Low in prose).

Language

Wrong: mixing languages in one post.

Right: English only for Evalgist accounts.

07Mechanics

Length, links, and hashtags.

Stay inside platform limits. Prefer clarity over trend chasing.

  • X: keep copy short; long-form posts are rare. Put the link in the post or rely on the card, not both with duplicate CTAs.
  • LinkedIn: intro text can run longer, but the first two lines must stand alone in the feed.
  • YouTube: title and description follow content-style; put primary links in the description.
  • Hashtags: at most two CamelCase tags per post (example: #HiringOps).
  • Links: use UTMs on evalgist.ai/shortlist, for example https://evalgist.ai/shortlist?utm_source=linkedin&utm_medium=social&utm_campaign=pilot_evidence
  • Emoji: avoid emoji spam; none in product-voice surfaces.
  • Engagement bait: never ask for likes, reposts, or reshares.
08Do and don't

One approved and one rejected crop per format.

Tiles use design-system tokens. Rejected crops break the visual rules on purpose.

X 16:9

Approved direction

Evalgist

Evidence stays attached.

X 16:9

Rejected direction

Rounded card with colored left border (list pattern, not social).

LinkedIn landscape

Approved direction

Evalgist Shortlist

Bands, not scores.

LinkedIn landscape

Rejected direction

87% match!!!

YouTube thumbnail

Approved direction

Shortlist screen

Review with evidence

YouTube thumbnail

Rejected direction

FAKE UI · quote glow not in product

Vertical 9:16

Approved direction

Evalgist

Vertical 9:16

Rejected direction

Invented resume highlight

OG / link preview

Approved direction

/api/og + grid

OG / link preview

Rejected direction

Logo-only card, no substance
09Operations

Review, accessibility, and change control.

No credential or account-security content in this guide. Operational security stays in internal runbooks.

Accessibility

every post

Alt text on every image. Captions or a transcript on every video.

Scheduling

breaking news

Pause scheduled posts during major breaking news. The marketing owner calls the pause; a reviewer confirms before posts resume.

Sign-off

before publish

A reviewer role approves copy, visuals, and links before anything goes live or is scheduled.

Review checklist

any author
  1. Screenshot is from production Shortlist (not a design comp).
  2. Copy matches packages/content-style and uses bands, not scores.
  3. Template size matches the channel table; safe zones respected.
  4. At most two CamelCase hashtags; UTMs present on evalgist.ai/shortlist links.
  5. Alt text written; video has captions or transcript.
  6. No engagement bait; English only; no emojis in product-voice posts.
  7. Reviewer sign-off recorded (ticket or doc link).

History

shared changelog

Social publishing changes are recorded in the design system changelog under Social (source: packages/design-system/CHANGELOG.md).