Factory docs, home
Page navigation

Pre-release documentation. Proposed designs are labelled in the page; acceptance evidence is maintained in the build review. Local paths appear as placeholders. Current state: Build review.

This is the precise construction behind the Factory brand. This defines the vector master and the direction for: generated assets, module studies and the hand-built SVG lockup.

Construction

Unit D = bob width.

PartMascotCompact mark
BobA point-down drop in Action blue. Its round top joins straight tangent sides that meet at a softly rounded tip. Total height 1.5D.Same
CollarNear-black flat band, 0.5D × about 0.14D, with slightly rounded corners, across the top of the bobSame
LineNear-black vertical stroke 0.06D wide, about 0.5 × bob height, ending in an open loop 0.18D acrossStroke 0.1D and about 0.4 × bob height, loop drawn with the same stroke
HighlightOne white crescent, upper leftNone
FaceTwo upright near-black oval eyes, each with a small white catch-light, just below the widest point, and a small gentle smile arcNone
ArmsOptional single near-black lines as thin as the line, ending in small rounded dots with no fingersNone
PoseTilt up to 12°; the line always stays attachedPerfectly vertical and mirror-symmetrical
OutlineOne uniform near-black outline weightNone; flat fills only

The core Plumb has no legs, hair, clothes, nose or eyebrows. Family v2 may use subtle eyebrows, round spectacles, different eye spacing, wider or slimmer bobs and shorter hanging lines. Several family members may appear together in an editorial gallery; each remains separately labelled.

Mark and lockup

  • Size. Use the generated mark at a minimum 48 × 48 px canvas. Review at 16, 24, 32, 48 and 64 px found the smaller versions indistinct. It is not an approved favicon. Clear space is 0.5D on every side. Check the SVG lockup at its actual placement size.
  • Lockup. The wordmark "Factory" is set in the system sans-serif at weight 750, in near-black. It sits to the right of the mark, with a gap of 0.5D. Its cap height is about 0.75 × the bob's height, and its baseline sits near the bob's tip.
  • Master files.
    • The hand-built vector lockup is assets/core/factory-lockup.svg. It is not image-generator output.
    • The generated PNG shares the silhouette; it is illustrative, not a pixel-exact rendering of this vector master.
  • In the UI. The dashboard keeps rendering the wordmark as live text. It may place the mark beside that text.

Palette

The core mark and functional UI use only design-system tokens, as flat fills. The owner-requested family v2 illustrations extend the editorial palette with indigo, violet, teal and warm paper. These are illustration colours only, not new UI tokens or status meanings.

ColourHexUse
Action blue#075beathe bob; at most one small prop detail
Near-black#080d1aline, collar, eyes, outlines, wordmark
Slate#58627bprop outlines and details
Pale blue#dceaffbackdrop tiles, ground shadows
Cool grey#f3f6faprop fills
Divider#dce2ecground lines
White#ffffffhighlight, plate canvas
  • A 40% tint of Action blue may shade the bob.
  • Keep UI and vector identity flat. Family v2 illustrations may retain modest cel shading and material accents, including a wax seal; no glow, photorealism or colour-coded status.
  • Meaningful foreground graphics need 3:1 contrast; normal text needs 4.5:1. Calculated token pairs: blue/white 5.69:1, blue/pale 4.67:1, ink/white 19.39:1, slate/white 6.09:1 and slate/pale 5.00:1.
  • Pale/white (1.22:1) and divider/white (1.30:1) are decorative only, never sole boundaries, information or state.
  • These ratios validate flat tokens, not every antialiased raster pixel. Generated studies retain small tonal variations; use exact flat tokens in functional interfaces.

Family variation

Family v2 was requested by the owner on 29 September 2026: related characters with different features and colours, one for every documented module and smaller companions for useful concepts. This extends the original prop-only studies; the original master and whole plates remain in the asset catalogue.

  • Shared identity. Point-down bob, attached line and open loop, dark collar, near-black outline, two expressive eyes, white highlight and warm curved smile. No legs or full costumes.
  • Individuality. Body width and height, eye shape and spacing, collar, colour, small spectacles and a signature prop may differ. Recognition must survive without colour.
  • Colour. Blue anchors the family; indigo, violet and teal broaden it. Cream paper and slate tools distinguish props. Colour never means accepted, healthy, blocked, important or finished.
  • Two scales. Module portraits are for 192 px and above; concept companions for 96 px and above. Smaller navigation uses the original identity mark. Preserve every full canvas and its alpha channel.
  • Editorial boundaries. Portraits belong below a factual introduction or in a labelled teaching gallery. Security, spend, actual Verdicts, Assessments, uncertain effects and errors remain plain words. The small Assessment companion teaches the concept; it never decorates an actual result.
  • Truth. Every module receives a portrait irrespective of its implementation status. A portrait is not an acceptance claim. Always read the module's separate status, limitations and evidence.
  • Reference. Family gallery, all prompts and mappings, assets.

Source: docs/brand/geometry.md