Company Style Guide

A code-built design system for Company. Every swatch, spacing bar, and component on this site is rendered from shared CSS — the single source of visual truth.

Getting started

Introduction

What this project is, how to install Node.js and npm, and how to run the site locally.

Foundations

Visual tokens and layout rules — read these before components.

Color

Palette, semantic colors, light and dark surfaces.

Typography

Open Sans type scale, weights, and specimens.

Icons

16/20/24px sizes, solid vs outline guidance.

Spacing

3px grid, margin and padding scale, usage rules.

Shape

Border radius, border width, corner treatments.

Elevation

Surface levels: sunken, default, raised, overlay.

Alignment

Label and control alignment patterns for forms.

Capitalization

Title Case vs Sentence case for labels, buttons, and dialogs.

Interactive controls

Interactive primitives and feedback — the building blocks of every screen.

Button

Primary, secondary, tertiary, outline — all states.

Hyperlinks

Inline, standalone, internal, external links, and menu arrows.

Checkboxes

Checkboxes vs radio buttons and accessibility.

Forms

Labels, inputs, selects, validation, and field spacing.

Dropdowns

Selection pickers and action menus.

Disabled Controls

Panel, subsection, and individual disable patterns.

Badge

Status pills, counts, and notifications.

Error Handling

Inline validation, alerts, toasts, and loading.

Layout & content

Structure, grouping, and progressive disclosure.

Dividers

Full-width, inset, and vertical dividing lines.

Borders

Per-control border rules and emphasis styles.

Cards

Vertical and horizontal content surfaces.

Lists

Single-line, two-line, and datatable-style rows.

Grid View

Tile-based file and media collections.

Carousel (Gallery)

Slideshow view with thumbnail strip.

Collapse

Progressive disclosure for secondary settings.

Feature Panels

Panel layout, sectioning, wizard flows, and button placement.

Navigation

Navbar

Global navigation, search, and responsive behavior.

Ribbon Groups

Company desktop ribbon layout and interaction.

Overlays

Contextual layers that sit above the main UI.

Tooltips & Popovers

Explain vs interact — behavior and styling.

Bubble (Balloon)

Interactive contextual overlays.

Dialogs

Modal and modeless dialogs with action placement.

UX principles

Mental models and laws that inform design decisions.

Laws of UX

Overview of heuristics, principles, Gestalt, and cognitive bias.

Heuristics

Fitts’s, Hick’s, Jakob’s, Miller’s, and related rules of thumb.

UX Principles

Doherty Threshold, Occam’s Razor, Tesler’s Law, and more.

Gestalt

Proximity, similarity, common region, and visual grouping.

Cognitive Bias

Peak-end rule, serial position, Von Restorff, and Zeigarnik effects.

Standards

Cross-cutting requirements for shipping production UI.

Responsive Design

Breakpoints, touch targets, adaptive layouts, and testing.

Accessibility

WCAG 2.1 AA compliance, contrast, and focus states.