← Hub Design Principles
v10.0
Design Philosophy
Design
Principles
Ten foundational principles that guide every design decision at Global Food Solutions. These are non-negotiable. They define what we build, how we build it, and why it matters.
10
00Principle IndexClick to Navigate
01
Precision Over Polish
02
Function First
03
Cold Chain Clarity
04
Scale Without Breaking
05
Consistent Not Rigid
06
Accessible By Default
07
Print Ready
08
Dark Mode Native
09
Frosty Friendly
10
Food Industry First
01
Precision Over Polish
Data accuracy matters more than decoration
+
In the food supply chain, a misread temperature, a wrong lot number, or an inaccurate weight has real consequences. Our design system prioritizes data accuracy and legibility above all visual embellishment. A correct number in a plain table is always better than a wrong number in a beautiful chart.
Correct Approach
Shipment Log
Lot B-7721 38.2F
Lot B-7722 44.1F
Clear data, monospace for numbers, color-coded status
Incorrect Approach
Shipments
Everything is looking great!
Warm gradient, rounded corners, vague text, no actual data
Related Pages
02
Function First
Every element serves a purpose
+
If an element does not help the user complete a task, understand data, or make a decision, it does not belong. Decorative elements are permitted only when they reinforce brand DNA (dot-matrix watermark, corner brackets, barcode accents) and never at the expense of function.
Correct Approach
Three distinct actions, clear hierarchy, minimal chrome
Incorrect Approach
Create PO
Export
Gradients, shadows, rounded pills, non-brand colors, unclear hierarchy
Related Pages
03
Cold Chain Clarity
Temperature and food safety info is always prominent
+
In food logistics, temperature is not secondary information -- it is primary. Cold chain data (temperature, humidity, transit time, compliance status) must always be immediately visible and never buried beneath other content. Semantic colors (success, warning, error) map directly to temperature safety zones.
Correct Approach
36.2F 41.8F 48.3F
Safe (32-40F) | Caution (40-45F) | Breach (45F+)
Temperature first, color-coded, monospace font, immediate status
Incorrect Approach
Shipment Details
Origin: Hermitage, PA
Destination: Edgewood, NY
Driver: John Smith
Temperature: 48.3F
ETA: 14:30 EST
Temperature buried in list, no color coding, breach undetectable at a glance
Related Pages
04
Scale Without Breaking
Works for 1 user or 1000
+
Every component, layout, and pattern must work at any scale. A data table must handle 5 rows and 5,000 rows. A dashboard must display one warehouse or one hundred. Grid systems use minmax(0,1fr) to prevent content overflow. Components never assume a fixed data size.
Correct Approach
/* Grid that adapts */
grid-template-columns:
  repeat(4, minmax(0, 1fr));
minmax(0,1fr) prevents content from blowing out columns
Incorrect Approach
/* Grid that breaks */
grid-template-columns:
  repeat(4, 1fr);
Plain 1fr allows content to overflow and break layout
Related Pages
05
Consistent Not Rigid
Same language everywhere, flexible execution
+
Consistency means using the same design tokens, typography, and component patterns across every page and application. Flexibility means those components adapt to their context. A data table on a dashboard looks different from one in a print report, but both use the same tokens. The system has rules, not cages.
Consistent Application
Dashboard
2,847
+12.4%
Report
2,847 units
YoY +12.4%
Same tokens, different density for context
Inconsistent Application
Dashboard
2,847
Total: 2847
Different fonts, colors, patterns -- no shared language
Related Pages
06
Accessible By Default
Not an afterthought
+
Accessibility is built into every token, component, and pattern from the start. WCAG 2.1 AA is the minimum standard. All text meets 4.5:1 contrast ratio. All interactive elements have visible focus states. All content is navigable by keyboard. Skip links, semantic HTML, and ARIA labels are required infrastructure, not optional additions.
Accessible Implementation
Aa
Cobalt on white: 10.7:1 contrast
Aa
Tufts on white: 3.5:1 (large text only)
Keyboard focus ring always visible
Inaccessible Implementation
Aa
Steel on silver: 1.9:1 -- fails WCAG
No Focus
outline:none removes keyboard visibility
Related Pages
07
Print Ready
Everything must look good printed
+
Food industry operations still rely heavily on printed documents: compliance reports, shipping manifests, spec sheets, quality audits. Every GFS page includes print.css and is designed to produce clean, readable output on A4/Letter paper. Interactive elements hide, tables get borders, and brand colors are preserved via print-color-adjust.
Print-Ready Design
print.css applied:
- Interactive elements hidden
- Tables have visible borders
- Section breaks avoid orphans
- URLs shown after links
- Brand colors preserved
- Footer stamp added automatically
Not Print-Ready
No print stylesheet:
- Navigation bar prints
- Buttons print (non-functional)
- Tables cut off at page break
- Dark backgrounds waste ink
- Links show as plain text
- No page numbers
Related Pages
08
Dark Mode Native
Not bolted on
+
Dark mode is not an afterthought or a filter applied on top. Every color token has a corresponding dark-mode value defined in [data-theme="dark"]. Blues invert luminance. Neutrals fully reverse. Semantic colors shift to lighter variants for readability. The entire system transforms cleanly through CSS custom property inheritance with zero JavaScript color manipulation.
Native Dark Mode
LIGHT
Cobalt Text
on white background
DARK
Cobalt Text
on dark background
Token swap only -- same structure, different values
Bolted-On Dark Mode
/* Fragile approach */
filter: invert(1) hue-rotate(180deg);

/* Breaks images, icons, brand colors */
CSS filter inversion breaks everything -- images, SVGs, brand colors
Related Pages
09
Frosty Friendly
The mascot enhances, never distracts
+
Frosty is the brand's friendly face in moments that benefit from warmth: onboarding, empty states, chat, error recovery. Frosty should never appear in formal documents, compliance outputs, or operational dashboards where data density is the priority. The mascot supports the experience without competing for attention.
Appropriate Frosty Use
No shipments yet
Create your first purchase order to get started.
Empty state: small, supportive, not the hero
Inappropriate Frosty Use
USDA Compliance Report
Facility #131 passed audit...
Compliance report is not the place for a mascot
Related Pages
10
Food Industry First
Designed for cheese, cold chain, and compliance
+
This is not a generic design system borrowed from tech and repainted blue. It is purpose-built for food supply chain operations: commodity cheese pricing, USDA compliance, cold chain monitoring, lot traceability, nutritional labeling, and procurement workflows. Every component, every pattern, and every page template considers the specific needs of food infrastructure.
Food Industry Context
CME Barrel Cheddar
$2.1825
Trailing Week Average
+$0.0475
vs. prior week
Industry-specific data component, not generic "dashboard widget"
Generic Tech Context
Revenue
$2.18
Trending up
Generic "revenue card" -- no industry context, wrong precision, vague label
Industry-Specific Components
Temperature Monitoring
Cold chain dashboards, temperature alerts, zone classification, breach reporting.
Lot Traceability
Lot number tables, FIFO drawdown tracking, bracket boundary displays, journal entries.
FDA / USDA Compliance
Nutritional label templates, spec sheets, compliance audit dashboards, facility licensing.
Related Pages
← Back to Hub · GFS Design System v10.0 · Global Food Solutions, Inc. · Edgewood, NY