# Full Stack House — visual reference for agents

Use this guide before making FSH slides, proposals, PDFs, ads or article artwork.
Visual overview: [EN](https://www.fullstack.house/brand) ·
[PL](https://www.fullstack.house/pl/brand).

## Sources and scope

- `fullstackhouse/fsh-marketing` owns the visual identity, artwork and this guide.
- [docs/blueprint.md](https://github.com/fullstackhouse/fsh-marketing/blob/main/docs/blueprint.md)
  owns the detailed website rules and the original family-A generation prompt.
  [app/globals.css](https://github.com/fullstackhouse/fsh-marketing/blob/main/app/globals.css)
  defines the implemented tokens. Reconcile differences explicitly; do not invent a second palette.
- The A/B/C families, palette and type roles below describe the existing identity.
  The editorial references describe shipped examples. The format
  defaults and prompt skeletons extend that identity to other media; they are new
  recommendations, not claims that document or ad templates already exist.
- Positioning, voice, approved claims and commercial terms belong to `fsh-gtm`.
  Read its current guidance when authorized; never turn a visual example into a
  client result, price or promise. This public guide contains no private sales material.

## Moodboard — identity studies

The visual board is image-led: large references, brief captions and a deliberate
sequence: identity, colors/type, illustration families, applications, then downloads.
Keep the page continuous, without accordions or duplicate specifications. Keep detailed rules and
generation instructions in this guide, separate from the board. Include imagery
because it demonstrates the identity, not simply because it exists in the repository.

Source: Figma [identity exploration](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=0-1)
and [brand studies](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=716-95).

| Study | Local export | Image / Figma source |
|---|---|---|
| Cherry | `public/brand/moodboard/cherry.webp` | [Image](https://www.fullstack.house/brand/moodboard/cherry.webp) · [730:1915](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=730-1915) |
| Ink | `public/brand/moodboard/ink.webp` | [Image](https://www.fullstack.house/brand/moodboard/ink.webp) · [730:1921](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=730-1921) |
| Cream | `public/brand/moodboard/cream.webp` | [Image](https://www.fullstack.house/brand/moodboard/cream.webp) · [731:1927](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=731-1927) |
| Print | `public/brand/moodboard/print.webp` | [Image](https://www.fullstack.house/brand/moodboard/print.webp) · [868:165](https://www.figma.com/design/9SA9wftMfk28RBE0KegUFO?node-id=868-165) |

These are inspiration studies, not production logos or ready-to-use print templates.
Use them for visual direction; use the supplied vector marks and exact palette below
for production. Do not extract a logo, sample replacement brand colors or infer
approved copy from a study.

## Core appearance

An engineer's drawing sheet: warm paper, precise hairlines, generous space,
numbered parts and one cherry accent. Serif headlines, quiet body text and mono
annotations. Prefer one clear subject or mechanism to a decorative collage.

| Role | Value |
|---|---|
| Background / Cream | `#F7F4F0` |
| Surface / Card | `#FDFCFA` |
| Main text / Ink | `#111110` |
| Secondary text | `#5A5750` |
| Hairlines | `#E0DBD5` |
| Single accent / Cherry | `#9E1B32` |
| Dark panel / light text | `#0E0E0F` / `#F4F4F2` |
| Headings | Instrument Serif, regular |
| Body | Inter |
| Labels, dates, numbers | IBM Plex Mono |
| Wordmark only | Space Grotesk; use the supplied logo |

Use cherry to mark the relevant part, a number or the primary action. It is not
a background wash for every panel. Use thin rules instead of shadows and rounded
cards. Keep mono labels short; never set a paragraph in mono. Dark panels provide
occasional emphasis. Photography and real product interfaces retain their own colors.

Use supplied marks without redrawing, recoloring, distortion or added effects:
[light-background logo](https://www.fullstack.house/fsh-lockup-light.svg),
[dark-background logo](https://www.fullstack.house/fsh-lockup-dark.svg),
[asset ZIP](https://www.fullstack.house/fullstack-house-brand-assets.zip).
Repository paths are `public/fsh-lockup-light.svg`, `public/fsh-lockup-dark.svg`
and `public/fullstack-house-brand-assets.zip`. Clear space: at least the roof wedge's height.

## Choose a reference by purpose

Paths below are relative to the marketing repo. Open the linked image and supply
it to the image model as a visual reference; a filename alone is not a reference.

| Family / purpose | Repository file and public reference |
|---|---|
| **A — modular object.** A business problem or state: matte off-white concrete, restrained charcoal, one cherry component, soft contact shadow, isometric camera. | `public/home/familiar-01.webp` · [800 × 533, transparent](https://www.fullstack.house/home/familiar-01.webp) |
| **B — CAD drawing.** A capability, service or mechanism: precise lines, visible assembly, cherry on the important part. New line art is SVG; preserve projection and line weight across a set. | `public/services/offer-automation-sprint.svg` · [vector reference](https://www.fullstack.house/services/offer-automation-sprint.svg). Generator: `scripts/offer-illustrations.mjs`. |
| **C — exploded stack.** A layered system or process: separated concrete slabs, one cherry layer. One per composition; keep any explanatory labels editable outside the generated art. | `public/home/faq-stack.webp` · [640 × 1205, transparent](https://www.fullstack.house/home/faq-stack.webp). This existing asset contains layer labels; do not copy those labels into a new subject. |
| **Editorial illustration.** An article about people, choices or work: graphite drawing, restrained shading, a recognizable scene, clear silhouette and little background. | `public/blog-media/10-mistakes-starting-a-new-job/arrival-cover.webp` · [1536 × 1024, transparent](https://www.fullstack.house/blog-media/10-mistakes-starting-a-new-job/arrival-cover.webp) |
| **Product screenshot.** Show actual behavior, interface or outcome. Preserve readable UI; use a deliberate crop and the matching language. | `public/work/metal-zbiorniki/quote-draft.webp` · [EN](https://www.fullstack.house/work/metal-zbiorniki/quote-draft.webp); `public/work/metal-zbiorniki/quote-draft.pl.webp` · [PL](https://www.fullstack.house/work/metal-zbiorniki/quote-draft.pl.webp) |

An article can use family A too: [Blacksmith's anvil](https://www.fullstack.house/blog-media/blacksmith-ci/intro.webp)
(`public/blog-media/blacksmith-ci/intro.webp`, 1200 × 800, transparent).
Choose by subject, not by channel. Do not mix drawing styles or camera angles in one set.
Older blog art varies; the references above are deliberate choices, not permission
to imitate every historical asset. Client UI is evidence, not FSH's design system.
Use genuine, approved photography when a piece needs evidence of people, a place or
work performed. Incidental team photos are not visual-style references and do not
belong in an identity moodboard merely because they are available.

## Format defaults — new cross-format recommendations

| Output | Composition and delivery |
|---|---|
| Slides | Start at 16:9. One claim per slide, one main visual, consistent margins. Start body text around 24 pt; verify at presentation size. Keep headline, figures and logo editable. |
| Proposal / PDF | A4 portrait unless the brief specifies otherwise. Start body text at 10.5–12 pt, with comfortable leading and generous margins. Use vector marks and diagrams. Embed fonts; inspect the exported PDF at 100% and in print. |
| Ads | Compose separately for the placement: 1:1 square, 4:5 portrait or 9:16 vertical are starting canvases. Verify the placement's current dimensions and safe areas before export. One message and action; do not squeeze a landscape composition into portrait. |
| Article artwork | Start at 3:2 with a legible subject and modest margins. Keep source artwork text-free and use real alpha for isolated subjects. Check its size next to the article text on desktop and mobile. |
| Blog social preview | Existing approved layout: Instrument Serif headline beside the hero in landscape, stacked in portrait. No summary in the image. Website OG output is 1200 × 630; use the current social renderer for its exact composition. |

Use roughly 8% internal padding for isolated A/B subjects, then inspect the actual
crop. Generate raster art at 2–3× its screen size; never upscale an undersized source.
For print, aim for 300 ppi at the placed size; existing website illustrations may
need a new high-resolution render. Check hairline visibility, contrast and body
size on the final medium. Do not assume pale web dividers will survive printing.
Retain editable source layouts alongside exports.

## Reusable generation briefs

**Modular object / family A** — use the full established prompt in
`docs/blueprint.md` §7, with the selected reference image attached. Add:

> Depict [one concrete business mechanism] as [specific arrangement of objects].
> Match the attached reference's material, isometric camera, proportions and shadow.
> Put the single deep-cherry accent on [the meaningful component]. Target [ratio],
> with room for [separate headline position]. Deliver an isolated subject with real
> transparency. No text, letters, logo or invented interface.

**Editorial article illustration** — attach the arrival-cover reference:

> Illustrate [one recognizable scene supporting the article's point]. Match the
> supplied graphite drawing's line quality and restrained shading. Keep the subject
> large enough to read at thumbnail size; simplify the background. Use at most one
> restrained cherry detail, only if it has meaning. Target [ratio], reserve [space]
> for separately typeset copy. Transparent background, no text or logo.

**Composition brief for slides, proposals and ads**:

> Make [format and dimensions] for [audience]. The approved message is [exact copy].
> Use the FSH palette and type roles above. Main visual: [reference + chosen family].
> Keep [headline / data / CTA / logo] as editable layout elements, outside the image.
> Use [cream / occasional ink panel], hairline structure and one cherry emphasis.
> Export [format]; inspect at [reading size] and check the required crop/safe area.

CAD diagrams should be authored as vectors; take the existing generator as the
reference rather than asking an image model to invent precise labels or connections.
Generated photography can illustrate a topic, but must not impersonate FSH's team,
a client site, a testimonial or proof of completed work. Use real photography for those.

## Before delivery

- Open the reference and final artifact side by side. Match materials, type roles,
  accent usage and scale; inspect every page and crop.
- Keep text and logo out of generated art. Add them in the layout; embed the real logo.
- Check transparency on cream and dark ground. Avoid a white rectangle around a cutout.
- No glossy plastic, neon gradients, generic blue tech imagery or decorative icon clouds.
- Verify legibility at thumbnail, slide or print size, not only zoomed in.
- Check Polish diacritics, font embedding and localized screenshot pairs. Never
  fabricate interface data, outcomes or customer details to fill the composition.
