Skip to content

README.md

Latest commit

 

History

History
82 lines (59 loc) · 4.67 KB

README.md

File metadata and controls

82 lines (59 loc) · 4.67 KB

CodeSignal Design System

This directory contains the core design tokens and reusable components for the application.

Demo

The demo of the design system can be found here: Demo Site

Structure

The design system is organized into Foundations and Components.

Foundations

Base definitions that drive the visual style.

  • Colors: Base scales and semantic color tokens.
  • Typography: Font families, sizes, and utility classes.
  • Spacing: Spacing, sizing, and radius tokens.

Components

Reusable UI elements built using the foundations.

  • Button (CSS): Primary, secondary, and utility buttons.
  • Boxes (CSS): Container components.
  • Dropdown (CSS, JS): Customizable dropdown menus.
  • Horizontal Cards (CSS, JS): Horizontal scrolling card carousel with navigation buttons and card centering.
  • Icons (CSS): Scalable SVG icons with size and color variants.
  • Input (CSS): Text, number, checkbox, and radio button inputs with various states and sizes.
  • Modal (CSS, JS): Customizable modal dialogs with flexible content insertion. Includes a help modal variant optimized for documentation.
  • Numeric Slider (CSS, JS): Single value and range sliders with optional input fields.
  • Split Panel (CSS, JS): Resizable split panel component with draggable divider for horizontal or vertical layouts.
  • Table (CSS): Editorial, read-only table layout with a scroll wrapper for horizontal overflow on small screens.
  • Tags (CSS): Label and status indicator tags.

Usage

Styles

Include the relevant CSS files in your HTML. For a full integration, you typically include:

<!-- Fonts (Work Sans) -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Work+Sans:wght@400;500;600;700&display=swap" rel="stylesheet">

<!-- Design System Foundations -->
<link rel="stylesheet" href="/design-system/colors/colors.css">
<link rel="stylesheet" href="/design-system/spacing/spacing.css">
<link rel="stylesheet" href="/design-system/typography/typography.css">

<!-- Design System Components -->
<link rel="stylesheet" href="/design-system/components/button/button.css">
<link rel="stylesheet" href="/design-system/components/boxes/boxes.css">
<link rel="stylesheet" href="/design-system/components/dropdown/dropdown.css">
<link rel="stylesheet" href="/design-system/components/horizontal-cards/horizontal-cards.css">
<link rel="stylesheet" href="/design-system/components/icons/icons.css">
<link rel="stylesheet" href="/design-system/components/input/input.css">
<link rel="stylesheet" href="/design-system/components/modal/modal.css">
<link rel="stylesheet" href="/design-system/components/numeric-slider/numeric-slider.css">
<link rel="stylesheet" href="/design-system/components/split-panel/split-panel.css">
<link rel="stylesheet" href="/design-system/components/table/table.css">
<link rel="stylesheet" href="/design-system/components/tags/tags.css">

Note on Fonts:

  • Work Sans: Must be imported via Google Fonts (as shown above).
  • Founders Grotesk: Included via @font-face in typography.css.
  • JetBrains Mono: Included via @font-face in typography.css.

Components

Components have their own CSS and JS files located within their respective directories. See individual component READMEs for implementation details.

Test Bed

You can view and test the design system elements by opening the test harness:

http://[your-server]/design-system/test.html

This provides a sidebar navigation to explore colors, typography, and interactive component demos.