Skip to content

The OBE:BS4 Design System is the world's first self-reflexive design system for web production.

License

Notifications You must be signed in to change notification settings

oberocks/obebs4

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OBE:BS4 Design System

The OBE:BS4 Web Design System is the world's first self-reflexive web design system for web production. OBE:BS4 is based on the most popular/robust front-end web framework in the world, Bootstrap! The OBE:BS4 system was designed & built to give all project stakeholders complete visual & tactile access to every color, font, element, component, & layout in a web project... before the project enters any design phases!

THE OBE:BS4 Web Design System was designed to bridge the gaps between web project owners, designers, and developers. OBE:BS4 achieves this goal by fostering a more healthy understanding of both code and design constraints in the context of the final output medium(s)... the web browsers!

Please Note: This project is fully functional as far as the generated CSS, JS, and library HTML files are concerned. However the code will receive substantial changes before being ready for all to use. Please consider this an alpha version, and keep an eye on this page to learn more about how everything works as documentation is figured out. Once the project is rezady, an offical release will follow!


Table of Contents


About The Project

The OBE:BS4 Web Design System is meant to nudge web projects, web teams, and even entire web organizations towards making both strategic & design related decisions about their projects exclusively within the contexts of the browsers. This approach has tremendous value, especially when seeking a high-caliber device agnostic web user experiences.

OBE:BS4 doesn't assume designers are incapable of learning how to hack a little markup or throw around some HTML snippets. Instead, the OBE:BS4 web design system arms designers with both visual and markup examples of anything/everything a designer might need to solve a web-based design problem.

"OBE:BS4 assumes that everyone working on a web project needs transparent access to each option and each limitation for the client-facing side of the project at all times." - Matt McT

Accomplishing this is done through a surprisingly simple operational tweak. The secret is creating a work flow where the front-end specialists are expected to give the design specialists a complete reference of all available design options provided by both browsers and any applicable libraries/frameworks.

Here's the catch though, and why this isn't happening all over the world today... all of this needs to happen before any design work begins!!! Designers need to see/touch whatever is available for use in designs, and also see/touch differences across browsers before they start thinking about how to best solve problems! The only way to do that though... would be to make a customizable website that displays... everything!? Who got time (or money) for dat???

Enter OBE:BS4! ;)

Additionally, what's magical about this situation from a developer's POV, is how it gives front-end specialists an opportunity to refactor and templatize elements/components at a production level, before any design sprints begin. This allows engineers to create amazingly DRY markup templates/scripts, and to engineer solutions the "right" way from the get-go according to the tech stack.

"The aspect of this project that excites me the most, is how much further a team's strategic thinking and prototyping can reach upon embracing the OBE:BS4 process. It becomes clear after using the system fully, that somehow we've all accidentily been doing this web stuff in the wrong order all these years! D'OH!" - Matt McT

The OBE:BS4 Web Design System positions all project stakeholders to think more strategically about responsive content issues, by abstracting the design options to proactively to solve those issues into a tangible digital "toolbox" of fully responsive and designer-ready pieces.

If each piece is in-turn proactively optimized for production (IE valid, semantic, cross-browser, ARIA accessibile, and refactored for reuse), teams find themselves with an abundance of cognative room to focus on the more meta-level goals of any given web project.


Project Color Wheel

To work with the OBE:BS4 Web Design System, it's important to understand the system's "color wheel." Before we dive in, let's cover why a color wheel was necessary to begin with!

Long story short, it started with the Bootstrap "contextual" color classes (primary, danger, etc.) which were combined with Google's Material Design color guidelines. Next, branding was factored in, including concerns for both digital and analog collateral design needs. To organize all of that complexity into a customizable solution, and to ensure contingency color options for both digital and analog design edge cases, the color wheel system emerged!

The color wheel itself is used to integrate any current branding into the OBE:BS4 build system. Then by using the system's built-in settings tool (Example: OBE:BS4 Settings Page), you can specify your settings, grab the generated JSON, replace your existing settings file with your new JSON data, and finally re-generate your library site (HTML, CSS, & JS files) with your new settings!

List of Color Wheel Colors

PRO TIP: If possible, try to memorize these slugs and patterns! Knowing these will let you iterate VERY rapidly!

Name CSS Slug JS Slug
Red red red
Rose rose rose
Magenta magenta magenta
Violet violet violet
Blue blue blue
Azure azure azure
Cyan cyan cyan
Spring Green spring-green springGreen
Green green green
Chartreuse chartreuse chartreuse
Yellow yellow yellow
Orange orange orange
Orange Gray orange-gray orangeGray
Dark Gray Orange dark-gray-orange darkGrayOrange
Blue Gray blue-gray blueGray
Light Gray Azure light-gray-azure lightGrayAzure
White white white
Light Gray light-gray lightGray
Gray gray gray
Dark Gray dark-gray darkGray
Black black black

Examples of Color Tints and Shades

PRO TIP: When using the Web Design System's tints and shades, each color gets a set of tint and shade values like the example for Blue below. Also for all color options with tints and shade classes, using the color slug without any numbers is equal to the 500 variation of that color. So for example, "Blue" is equal to "Blue 500", "White" to "White 500", and so on!

Name CSS Slug JS Slug
Blue 50 blue-50 blue50
Blue 100 blue-100 blue100
Blue 200 blue-200 blue200
Blue 300 blue-300 blue300
Blue 400 blue-400 blue400
Blue blue blue
Blue 500 blue-500 blue500
Blue 600 blue-600 blue600
Blue 700 blue-700 blue700
Blue 800 blue-800 blue800
Blue 900 blue-900 blue900

The Color Codes Table

The OBE:BS4 web design system allows you to centralize your brand colors for web projects. It can also be used for non-web design disciplines, too. OBE:BS4 makes the challenge of keeping brand colors consistent across projects/mediums trivial.

If you host your library, Visual Designers can use the web design system's client-side generated Color Reference Table to quickly find color codes for each color in the system. This means that it takes only seconds to add exact colors (even recently updated colors ;) into Photoshop, Illustrator, PowerPoint, Social Network account settings, video work, and so much more.

The Color Codes Table is basically the best tool your team never knew they needed.

Accessing Colors with JavaScript

The Color Codes Table is great for designers and marketers and all... but what about when those color codes are needed in JavaScript???

That's exactly what the client-side generated JavaScript/JSON Snippets part of the system is for!

A developer can simply parse the generated JSON strings, and access the color codes using the JS Slugs conventions in the table above.

For example, you could to make a seperate JavaScript file, and parse your colors JSON string as you assign it to a variable. Then you can include/require it on pages/components as needed. Here's a super simplified way to demonstrate how to use OBE:BS4 color wheel colors in JavaScript:

// EXAMPLE: An external .js file named brandColors.js
const brandColors = JSON.parse('PASTE_RGBa_JSON_INSIDE_THESE_QUOTES');
// EXAMPLE: Utility function to customize the alpha value of an rgba string
// NOTE: The Default alpha value for all RGBa strings is: '0.5'
const setRGBa = function (rgbaString, alphaValue) {
    return alphaValue ? rgbaString.replace('0.5', alphaValue) : rgbaString;
}

// EXAMPLE IN ACTION:
let darkGray = setRGBa( myColors.darkGray.rgba, '0.75' );

Project Workflow

Because the system compiles a full HTML library site along with the extended Bootstrap 4 CSS/JS files the library site uses, there is a lot going on under the hood.

Working with the system generally revolves around two types of uses. You either update settings (using the client-side tool in the rendered site files) or add new items to your system Nunjucks library files and/or Bootstrap integrated SASS files. Either way, you re-render the library site (and generally host it for the team to use from any device).

Some folks like to host the site on a subdomain, and others as a subdirectory. Devs can simply install it locally and work from their workstation.

Here's a diagram to illustrate the intended workflow:

OBE:BS4 Build Process - The Big Picture

It's worth noting, that new projects and prototypes aren't necessarily a part of the library. To try out new ideas, it's best to use a boilerplate provided by the web design system, with a fresh HTML file. However, when creating new components or element variations, you often will want to add your awesome creation into the library for your team and projects to use freely.

(More on extending the library with your own components/elements as the project matures a bit past this intial alpha stage! See the roadmap section for more!)

Project Directories

This project consists of 3 project directories and a handful of process files, that are intended to be a part of your project's root directory.

  • obebs4
    • core
      • css
      • images
      • js
    • data
    • prismjs
      • css
      • js
    • scss
      • mixins
      • settings
      • utilities
  • library
    • css
    • images
      • favicons
    • js
  • nunjucks
    • data
    • pages
    • templates
      • partials
        • boilerplates
        • colors
        • defaults
        • extensions
        • icons
        • layouts
        • macros
        • reference
        • settings
  • package.json, gulpfile.js, etc.

Installation

You'll need to use Node.js/NPM to install OBE:BS4 as a node module through your workstation's console.

To really start using your Web Design System however, you'll need to use an OBE:BS4 Settings Tool page to get the JSON settings to customize your Web Design System. (Coversely you could also get your JSON settings from the project's offical example OBE:BS4 Settings Page).

Then you'll need to use Gulp to run the scripts needed to apply your settings and re-generate the HTML, CSS, and JS files for your library. Then you are ready to use your Web Design System to make amazing web stuff!

NOTE: This project uses Gulp to manage and generate the Web Design System Library Site. So if you are already using Gulp, be sure to not override your gulpfile.js file with the OBE:BS4 gulpfile!

Installing via NPM

Step 1: Create a new directory for your project, and navigate to your new project directory in your console.

Step 2: Initialize NPM, and fill out your project info for your package.json file as prompted by NPM.

npm init

Step 3: Install obebs4 from GitHub (NPM will install all dependencies along with a directory called 'obebs4' inside your 'node_modules' directory)

npm install --save oberocks/obebs4#master

Step 4: Open up the OBE:BS4 Settings Page

open node_modules/obebs4/library/settings.html

Step 5: Use the OBE:BS4 Settings Page to set your colors and choose the options you want included in your library and brand CSS/JS files. Click the 'GET JSON & LINK' button to get your OBE:BS4 JSON settings. (See Project Color Wheel for more info!)

Step 6: Create a new file (should be in your project's root directory) called: obebs4_settings.json

touch obebs4_settings.json

Step 7: Now paste in your OBE:BS4 JSON settings into your newly created obebs4_settings.json file, and save the file.

Step 8: Next you'll want to set your FontAwesome version in your project's package.json file. To do this, simply check out the most recent FontAwesome version, then adjust the line below accordingly with the newest FA version number, and finally add it in just below your package.json file's "version": "X.X.X" key/value pair (don't forget the ending comma!):

"faversion": "5.12.1",

Step 9: If you don't have a gulp file in your project yet, just run this command to add it from the OBE:BS4 module files:

cp node_modules/obebs4/example-gulpfile.js gulpfile.js

Step 10: Next you'll need to add the following npm script (or scripts) to your project's package.json file:

"scripts": {
  "obebs4": "node ./node_modules/gulp/bin/gulp.js obebs4"
}
"scripts": {
  "obebs4": "node ./node_modules/gulp/bin/gulp.js obebs4",
  "ingest_obebs4_settings": "node ./node_modules/gulp/bin/gulp.js ingest_obebs4_settings",
  "compile_sass": "node ./node_modules/gulp/bin/gulp.js compile_sass",
  "move_images": "node ./node_modules/gulp/bin/gulp.js move_images",
  "move_favicons": "node ./node_modules/gulp/bin/gulp.js move_favicons",
  "compile_nunjucks": "node ./node_modules/gulp/bin/gulp.js compile_nunjucks",
  "concat_library_js": "node ./node_modules/gulp/bin/gulp.js concat_library_js",
  "concat_production_js": "node ./node_modules/gulp/bin/gulp.js concat_production_js",
  "concat_wds_js": "node ./node_modules/gulp/bin/gulp.js concat_wds_js",
  "concat_plugins_js": "node ./node_modules/gulp/bin/gulp.js concat_plugins_js",
  "copy_prism_js": "node ./node_modules/gulp/bin/gulp.js copy_prism_js",
  "copy_datatables_js": "node ./node_modules/gulp/bin/gulp.js copy_datatables_js",
  "copy_tinycolor_js": "node ./node_modules/gulp/bin/gulp.js copy_tinycolor_js",
  "concat_css": "node ./node_modules/gulp/bin/gulp.js concat_css",
  "concat_production_css": "node ./node_modules/gulp/bin/gulp.js concat_production_css",
  "concat_wds_css": "node ./node_modules/gulp/bin/gulp.js concat_wds_css",
  "concat_plugins_css": "node ./node_modules/gulp/bin/gulp.js concat_plugins_css",
  "copy_prism_css": "node ./node_modules/gulp/bin/gulp.js copy_prism_css",
  "copy_datatables_css": "node ./node_modules/gulp/bin/gulp.js copy_datatables_css",
  "clean_up": "node ./node_modules/gulp/bin/gulp.js clean_up"
}

Step 11: Now it's time to compile your library site! To do that, run the following gulp command in your console:

npm run obebs4

Step 12: Open up your home page:

open library/index.html

Or your boilerplate page ;)

open library/boilerplates.html

Updating Versions

You'll often find yourself in a position to update your OBE:BS4 web design system to get the newest goodies available in your current project. To update the system, use the following command(s):

Updating OBE:BS4 to Latest Version

First use npm install:

npm install oberocks/obebs4#master --save

Updating OBE:BS4 Build Scripts for Gulp

If your project is using Gulp in any way, you won't want to overwrite your project's build scripts with the OBE:BS4 gulp file scripts! In this case, you'll need to use the first command from the following options:

If Project IS using Gulp: you'll just want to open the file and manually copy over the new gulpfile.js scripts to your project gulpfile.js file using:

open node_modules/obebs4/example-gulpfile.js

If Project IS NOT using Gulp: Then simply update your current OBE:BS4 gulpfile.js file to the new one with:

cp node_modules/obebs4/example-gulpfile.js gulpfile.js

Updating OBE:BS4 obebs4_settings.json file

While this project is in an alpha stage, whenever changes are made to the default obebs4_settings.json project file, and you are already using an obebs4_settings.json file in your project, you might want to update the obebs4_settings.json file manually - allowing you to run the library generation script and see these settings reflected correctly in the Library Settings Page.

The following changes were made to the default obebs4_settings.json file during the BE:BS4 v0.8.* upgrades:

"enable-caret": "true",
"enable-rounded": "true",
"enable-shadows": "false",
"enable-gradients": "false",
"enable-transitions": "true",
"enable-prefers-reduced-motion-media-query": "true",
"enable-grid-classes": "true",
"enable-pointer-cursor-for-buttons": "true",
"enable-print-styles": "true",
"enable-responsive-font-sizes": "false",
"enable-validation-icons": "true",
"enable-deprecation-messages": "true",
"enable-obewds-fill-wheel-colors": "true",
"enable-obewds-fill-tints-shades": "true",
"enable-obewds-stroke-wheel-colors": "true",
"enable-obewds-stroke-tints-shades": "true",
"color-50-lighten-percent": "30%",
"color-100-lighten-percent": "20%",
"color-200-lighten-percent": "15%",
"color-300-lighten-percent": "10%",
"color-400-lighten-percent": "5%",
"color-600-darken-percent": "5%",
"color-700-darken-percent": "10%",
"color-800-darken-percent": "15%",
"color-900-darken-percent": "20%",
"theme-color-interval": "8%",
"yiq-contrasted-threshold": "150",
"yiq-text-dark": "$gray-900",
"yiq-text-light": "$white",
"escaped-characters": "( (\"<\",\"%3c\"), (\">\",\"%3e\"), (\"#\",\"%23\") )",

"spacer": "1rem",

"link-hover-color": "darken($link-color, 15%)",
"emphasized-link-hover-darken-percentage": "15%",

"paragraph-margin-bottom": "1rem",

"grid-breakpoints": "( xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px )",
"container-max-widths": "( sm: 540px, md: 720px, lg: 960px, xl: 1140px )",
"grid-columns": "12",
"grid-gutter-width": "30px",
"grid-row-columns": "6",

"line-height-lg": "1.5",
"line-height-sm": "1.5",
"border-width": "1px",
"border-color": "$gray-300",
"border-radius": "0.25rem",
"border-radius-lg": "0.3rem",
"border-radius-sm": "0.2rem",
"rounded-pill": "50rem",
"box-shadow-sm" : "0 0.125rem 0.25rem rgba($black, 0.075)",
"box-shadow": "0 0.5rem 1rem rgba($black, 0.15)",
"box-shadow-lg": "0 1rem 3rem rgba($black, 0.175)",
"caret-width": "0.3em",
"caret-vertical-align": "$caret-width * 0.85",
"caret-spacing": "$caret-width * 0.85",
"transition-base": "all 0.2s ease-in-out",
"transition-fade": "opacity 0.15s linear",
"transition-collapse": "height 0.35s ease",

"font-family-base": "$font-family-sans-serif",
"font-size-base": "1rem",
"font-size-lg": "$font-size-base * 1.25",
"font-size-sm": "$font-size-base * 0.875",
"font-weight-lighter": "lighter",
"font-weight-light": "300",
"font-weight-normal": "400",
"font-weight-bold": "700",
"font-weight-bolder": "bolder",
"font-weight-base": "$font-weight-normal",
"line-height-base": "1.5",
"h1-font-size": "$font-size-base * 2.5",
"h2-font-size": "$font-size-base * 2",
"h3-font-size": "$font-size-base * 1.75",
"h4-font-size": "$font-size-base * 1.5",
"h5-font-size": "$font-size-base * 1.25",
"h6-font-size": "$font-size-base",
"headings-margin-bottom": "$spacer / 2",
"headings-font-family": "null",
"headings-font-weight": "500",
"headings-line-height": "1.2",
"headings-color": "null",
"display1-size": "6rem",
"display2-size": "5.5rem",
"display3-size": "4.5rem",
"display4-size": "3.5rem",
"display1-weight": "300",
"display2-weight": "300",
"display3-weight": "300",
"display4-weight": "300",
"display-line-height": "$headings-line-height",
"lead-font-size": "$font-size-base * 1.25",
"lead-font-weight": "300",
"small-font-size": "80%",
"text-muted": "$gray-600",
"blockquote-small-color": "$gray-600",
"blockquote-small-font-size": "$small-font-size",
"blockquote-font-size": "$font-size-base * 1.25",
"hr-border-color": "rgba($black, 0.1)",
"hr-border-width": "$border-width",
"mark-padding": "0.2em",
"dt-font-weight": "$font-weight-bold",
"kbd-box-shadow": "inset 0 -0.1rem 0 rgba($black, 0.25)",
"nested-kbd-font-weight": "$font-weight-bold",
"list-inline-padding": "0.5rem",
"hr-margin-y": "$spacer",

"table-cell-padding": "0.75rem",
"table-cell-padding-sm": "0.3rem",
"table-color": "$body-color",
"table-bg": "null",
"table-accent-bg": "rgba($black, .05)",
"table-hover-color": "$table-color",
"table-hover-bg": "rgba($black, 0.075)",
"table-active-bg": "$table-hover-bg",
"table-border-width": "$border-width",
"table-border-color": "$border-color",
"table-head-bg": "$gray-200",
"table-head-color": "$gray-700",
"table-dark-color": "$white",
"table-dark-bg": "$gray-800",
"table-dark-accent-bg": "rgba($white, 0.05)",
"table-dark-hover-color": "$table-dark-color",
"table-dark-hover-bg": "rgba($white, 0.075)",
"table-dark-border-color": "lighten($table-dark-bg, 7.5%)",
"table-striped-order": "odd",
"table-caption-color": "$text-muted",
"table-bg-level": "-9",
"table-border-level": "-6",

"input-btn-padding-y": "0.375rem",
"input-btn-padding-x": "0.75rem",
"input-btn-font-family": "null",
"input-btn-font-size": "$font-size-base",
"input-btn-line-height": "$line-height-base",
"input-btn-focus-width": "0.2rem",
"input-btn-focus-color": "rgba($component-active-bg, 0.25)",
"input-btn-focus-box-shadow": "0 0 0 $input-btn-focus-width $input-btn-focus-color",
"input-btn-padding-y-sm": "0.25rem",
"input-btn-padding-x-sm": "0.5rem",
"input-btn-font-size-sm": "$font-size-sm",
"input-btn-line-height-sm": "$line-height-sm",
"input-btn-padding-y-lg": "0.5rem",
"input-btn-padding-x-lg": "1rem",
"input-btn-font-size-lg": "$font-size-lg",
"input-btn-line-height-lg": "$line-height-lg",
"input-btn-border-width": "$border-width",

"btn-padding-y": "$input-btn-padding-y",
"btn-padding-x": "$input-btn-padding-x",
"btn-font-family": "$input-btn-font-family",
"btn-font-size": "$input-btn-font-size",
"btn-line-height": "$input-btn-line-height",
"btn-white-space": "null",
"btn-padding-y-sm": "$input-btn-padding-y-sm",
"btn-padding-x-sm": "$input-btn-padding-x-sm",
"btn-font-size-sm": "$input-btn-font-size-sm",
"btn-line-height-sm": "$input-btn-line-height-sm",
"btn-padding-y-lg": "$input-btn-padding-y-lg",
"btn-padding-x-lg": "$input-btn-padding-x-lg",
"btn-font-size-lg": "$input-btn-font-size-lg",
"btn-line-height-lg": "$input-btn-line-height-lg",
"btn-border-width": "$input-btn-border-width",
"btn-font-weight": "$font-weight-normal",
"btn-box-shadow": "inset 0 1px 0 rgba($white, .15), 0 1px 1px rgba($black, .075)",
"btn-focus-width": "$input-btn-focus-width",
"btn-focus-box-shadow": "$input-btn-focus-box-shadow",
"btn-disabled-opacity": "0.65",
"btn-active-box-shadow": "inset 0 3px 5px rgba($black, .125)",
"btn-link-disabled-color": "$gray-600",
"btn-block-spacing-y": "0.5rem",
"btn-border-radius": "$border-radius",
"btn-border-radius-lg": "$border-radius-lg",
"btn-border-radius-sm": "$border-radius-sm",
"btn-transition": "color .15s ease-in-out, background-color .15s ease-in-out, border-color .15s ease-in-out, box-shadow .15s ease-in-out"
"label-margin-bottom": "0.5rem",
"input-padding-y": "$input-btn-padding-y",
"input-padding-x": "$input-btn-padding-x",
"input-font-family": "$input-btn-font-family",
"input-font-size": "$input-btn-font-size",
"input-font-weight": "$font-weight-base",
"input-line-height": "$input-btn-line-height",
"input-padding-y-sm": "$input-btn-padding-y-sm",
"input-padding-x-sm": "$input-btn-padding-x-sm",
"input-font-size-sm": "$input-btn-font-size-sm",
"input-line-height-sm": "$input-btn-line-height-sm",
"input-padding-y-lg": "$input-btn-padding-y-lg",
"input-padding-x-lg": "$input-btn-padding-x-lg",
"input-font-size-lg": "$input-btn-font-size-lg",
"input-line-height-lg": "$input-btn-line-height-lg",

"input-border-color": "$gray-400",
"input-border-width": "$input-btn-border-width",
"input-box-shadow": "inset 0 1px 1px rgba($black, .075)",
"input-border-radius": "$border-radius",
"input-border-radius-lg": "$border-radius-lg",
"input-border-radius-sm": "$border-radius-sm",
"input-focus-bg": "$input-bg",
"input-focus-border-color": "lighten($component-active-bg, 25%)",
"input-focus-color": "$input-color",
"input-focus-width": "$input-btn-focus-width",
"input-focus-box-shadow": "$input-btn-focus-box-shadow",
"input-plaintext-color": "$body-color",
"input-height-border": "$input-border-width * 2",
"input-height-inner": "add($input-line-height * 1em, $input-padding-y * 2)",
"input-height-inner-half": "add($input-line-height * .5em, $input-padding-y)",
"input-height-inner-quarter": "add($input-line-height * .25em, $input-padding-y / 2)",
"input-height": "add($input-line-height * 1em, add($input-padding-y * 2, $input-height-border, false))",
"input-height-sm": "add($input-line-height-sm * 1em, add($input-padding-y-sm * 2, $input-height-border, false))",
"input-height-lg": "add($input-line-height-lg * 1em, add($input-padding-y-lg * 2, $input-height-border, false))",
"input-transition": "border-color .15s ease-in-out, box-shadow .15s ease-in-out",
"form-text-margin-top": "0.25rem",
"form-check-input-gutter": "1.25rem",
"form-check-input-margin-y": "0.3rem",
"form-check-input-margin-x": "0.25rem",
"form-check-inline-margin-x": "0.75rem",
"form-check-inline-input-margin-x": "0.3125rem",
"form-grid-gutter-width": "10px",
"form-group-margin-bottom": "1rem",

"input-group-addon-border-color": "$input-border-color",
"custom-forms-transition": "background-color .15s ease-in-out, border-color .15s ease-in-out, box-shadow .15s ease-in-out",
"custom-control-gutter": "0.5rem",
"custom-control-spacer-x": "1rem",
"custom-control-cursor": "null",
"custom-control-indicator-size": "1rem",
"custom-control-indicator-bg": "$input-bg",
"custom-control-indicator-bg-size": "50% 50%",
"custom-control-indicator-box-shadow": "$input-box-shadow",
"custom-control-indicator-border-color": "$gray-500",
"custom-control-indicator-border-width": "$input-border-width",
"custom-control-label-color": "null",
"custom-control-indicator-disabled-bg": "$input-disabled-bg",
"custom-control-label-disabled-color": "$gray-600",
"custom-control-indicator-checked-color": "$component-active-color",
"custom-control-indicator-checked-bg": "$component-active-bg",
"custom-control-indicator-checked-disabled-bg": "rgba($primary, .5)",
"custom-control-indicator-checked-box-shadow": "none",
"custom-control-indicator-checked-border-color": "$custom-control-indicator-checked-bg",
"custom-control-indicator-focus-box-shadow": "$input-focus-box-shadow",
"custom-control-indicator-focus-border-color": "$input-focus-border-color",
"custom-control-indicator-active-color": "$component-active-color",
"custom-control-indicator-active-bg": "lighten($component-active-bg, 35%)",
"custom-control-indicator-active-box-shadow": "none",
"custom-control-indicator-active-border-color": "$custom-control-indicator-active-bg",
"custom-checkbox-indicator-border-radius": "$border-radius",

"custom-checkbox-indicator-icon-checked": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='8' height='8' viewBox='0 0 8 8'><path fill='#{$custom-control-indicator-checked-color}' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26l2.974 2.99L8 2.193z'/></svg>\")",
"custom-checkbox-indicator-indeterminate-bg": "$component-active-bg",
"custom-checkbox-indicator-indeterminate-color": "$custom-control-indicator-checked-color",
"custom-checkbox-indicator-icon-indeterminate": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='4' height='4' viewBox='0 0 4 4'><path stroke='#{$custom-checkbox-indicator-indeterminate-color}' d='M0 2h4'/></svg>\")",
"custom-checkbox-indicator-indeterminate-box-shadow": "none",
"custom-checkbox-indicator-indeterminate-border-color": "$custom-checkbox-indicator-indeterminate-bg",
"custom-radio-indicator-border-radius": "50%",
"custom-radio-indicator-icon-checked": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='-4 -4 8 8'><circle r='3' fill='#{$custom-control-indicator-checked-color}'/></svg>\")",
"custom-switch-width": "$custom-control-indicator-size * 1.75",
"custom-switch-indicator-border-radius": "$custom-control-indicator-size / 2",
"custom-switch-indicator-size": "subtract($custom-control-indicator-size, $custom-control-indicator-border-width * 4)",
"custom-select-padding-y": "$input-padding-y",
"custom-select-padding-x": "$input-padding-x",
"custom-select-font-family": "$input-font-family",
"custom-select-font-size": "$input-font-size",
"custom-select-height": "$input-height",
"custom-select-indicator-padding": "1rem",
"custom-select-font-weight": "$input-font-weight",
"custom-select-line-height": "$input-line-height",
"custom-select-color": "$input-color",

"custom-select-disabled-color": "$gray-600",
"custom-select-bg": "$input-bg",
"custom-select-disabled-bg": "$gray-200",
"custom-select-bg-size": "8px 10px",
"custom-select-indicator-color": "$gray-800",
"custom-select-indicator": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='4' height='5' viewBox='0 0 4 5'><path fill='#{$custom-select-indicator-color}' d='M2 0L0 2h4zm0 5L0 3h4z'/></svg>\")",
"custom-select-background": "escape-svg($custom-select-indicator) no-repeat right $custom-select-padding-x center / $custom-select-bg-size",
"custom-select-feedback-icon-padding-right": "add(1em * .75, (2 * $custom-select-padding-y * .75) + $custom-select-padding-x + $custom-select-indicator-padding)",
"custom-select-feedback-icon-position": "center right ($custom-select-padding-x + $custom-select-indicator-padding)",
"custom-select-feedback-icon-size": "$input-height-inner-half $input-height-inner-half",
"custom-select-border-width": "$input-border-width",
"custom-select-border-color": "$input-border-color",
"custom-select-border-radius": "$border-radius",
"custom-select-box-shadow": "inset 0 1px 2px rgba($black, .075)",
"custom-select-focus-border-color": "$input-focus-border-color",
"custom-select-focus-width": "$input-focus-width",
"custom-select-focus-box-shadow": "0 0 0 $custom-select-focus-width $input-btn-focus-color",
"custom-select-padding-y-sm": "$input-padding-y-sm",
"custom-select-padding-x-sm": "$input-padding-x-sm",
"custom-select-font-size-sm": "$input-font-size-sm",
"custom-select-height-sm": "$input-height-sm",
"custom-select-padding-y-lg": "$input-padding-y-lg",
"custom-select-padding-x-lg": "$input-padding-x-lg",
"custom-select-font-size-lg": "$input-font-size-lg",
"custom-select-height-lg": "$input-height-lg",

"custom-range-track-width": "100%",
"custom-range-track-height": "0.5rem",
"custom-range-track-cursor": "pointer",
"custom-range-track-bg": "$gray-300",
"custom-range-track-border-radius": "1rem",
"custom-range-track-box-shadow": "inset 0 .25rem .25rem rgba($black, .1)",
"custom-range-thumb-width": "1rem",
"custom-range-thumb-height": "$custom-range-thumb-width",
"custom-range-thumb-bg": "$component-active-bg",
"custom-range-thumb-border": "0",
"custom-range-thumb-border-radius": "1rem",
"custom-range-thumb-box-shadow": "0 .1rem .25rem rgba($black, .1)",
"custom-range-thumb-focus-box-shadow": "0 0 0 1px $body-bg, $input-focus-box-shadow",
"custom-range-thumb-focus-box-shadow-width": "$input-focus-width",
"custom-range-thumb-active-bg": "lighten($component-active-bg, 35%)",
"custom-range-thumb-disabled-bg": "$gray-500",

"custom-file-height": "$input-height",
"custom-file-height-inner": "$input-height-inner",
"custom-file-focus-border-color": "$input-focus-border-color",
"custom-file-focus-box-shadow": "$input-focus-box-shadow",
"custom-file-disabled-bg": "$input-disabled-bg",
"custom-file-padding-y": "$input-padding-y",
"custom-file-padding-x": "$input-padding-x",
"custom-file-line-height": "$input-line-height",
"custom-file-font-family": "$input-font-family",
"custom-file-font-weight": "$input-font-weight",
"custom-file-color": "$input-color",
"custom-file-bg": "$input-bg",
"custom-file-border-width": "$input-border-width",
"custom-file-border-color": "$input-border-color",
"custom-file-border-radius": "$input-border-radius",
"custom-file-box-shadow": "$input-box-shadow",
"custom-file-button-color": "$custom-file-color",
"custom-file-button-bg": "$input-group-addon-bg",
"custom-file-text": "( en: \"Browse\" )",
"form-feedback-margin-top": "$form-text-margin-top",
"form-feedback-font-size": "$small-font-size",
"form-feedback-valid-color": "$success",
"form-feedback-invalid-color": "$danger",
"form-feedback-icon-valid-color": "$form-feedback-valid-color",
"form-feedback-icon-valid": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='8' height='8' viewBox='0 0 8 8'><path fill='#{$form-feedback-icon-valid-color}' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/></svg>\")",
"form-feedback-icon-invalid-color": "$form-feedback-invalid-color",
"form-feedback-icon-invalid": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='12' height='12' fill='none' stroke='#{$form-feedback-icon-invalid-color}' viewBox='0 0 12 12'><circle cx='6' cy='6' r='4.5'/><path stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/><circle cx='6' cy='8.2' r='.6' fill='#{$form-feedback-icon-invalid-color}' stroke='none'/></svg>\")",
"form-validation-states-init": "()",
"form-validation-states": "map-merge( ( \"valid\": ( \"color\": $form-feedback-valid-color, \"icon\": $form-feedback-icon-valid ), \"invalid\": ( \"color\": $form-feedback-invalid-color, \"icon\": $form-feedback-icon-invalid ), ), $form-validation-states-init )",
"zindex-dropdown": "1000",
"zindex-sticky": "1020",
"zindex-fixed": "1030",
"zindex-modal-backdrop": "1040",
"zindex-modal": "1050",
"zindex-popover": "1060",
"zindex-tooltip": "1070"
"nav-link-padding-y": "0.5rem",
"nav-link-padding-x": "1rem",
"nav-link-disabled-color": "$gray-600",
"nav-tabs-border-color": "$gray-300",
"nav-tabs-border-width": "$border-width",
"nav-tabs-border-radius": "$border-radius",
"nav-tabs-link-hover-border-color": "$gray-200 $gray-200 $nav-tabs-border-color",
"nav-tabs-link-active-color": "$gray-700",
"nav-tabs-link-active-bg": "$body-bg",
"nav-tabs-link-active-border-color": "$gray-300 $gray-300 $nav-tabs-link-active-bg",
"nav-pills-border-radius": "$border-radius",
"nav-pills-link-active-color": "$component-active-color",
"nav-pills-link-active-bg": "$component-active-bg",
"nav-divider-color": "$gray-200",
"nav-divider-margin-y": "$spacer / 2",
"navbar-padding-y": "$spacer / 2",
"navbar-padding-x": "$spacer",
"navbar-nav-link-padding-x": "0.5rem",
"navbar-brand-font-size": "$font-size-lg",
"nav-link-height": "$font-size-base * $line-height-base + $nav-link-padding-y * 2",
"navbar-brand-height": "$navbar-brand-font-size * $line-height-base",
"navbar-brand-padding-y": "($nav-link-height - $navbar-brand-height) / 2",
"navbar-toggler-padding-y": "0.25rem",
"navbar-toggler-padding-x": "0.75rem",
"navbar-toggler-font-size": "$font-size-lg",
"navbar-toggler-border-radius": "$btn-border-radius",
"navbar-dark-color": "rgba($white, 0.5)",
"navbar-dark-hover-color": "rgba($white, 0.75)",
"navbar-dark-active-color": "$white",
"navbar-dark-disabled-color": "rgba($white, 0.25)",
"navbar-dark-toggler-icon-bg": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='30' height='30' viewBox='0 0 30 30'><path stroke='#{$navbar-dark-color}' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/></svg>\")",
"navbar-dark-toggler-border-color": "rgba($white, 0.1)",
"navbar-light-color": "rgba($black, 0.5)",
"navbar-light-hover-color": "rgba($black, 0.7)",
"navbar-light-active-color": "rgba($black, 0.9)",
"navbar-light-disabled-color": "rgba($black, 0.3)",
"navbar-light-toggler-icon-bg": "url(\"data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' width='30' height='30' viewBox='0 0 30 30'><path stroke='#{$navbar-light-color}' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/></svg>\")",
"navbar-light-toggler-border-color": "rgba($black, 0.1)",
"navbar-light-brand-color": "$navbar-light-active-color",
"navbar-light-brand-hover-color": "$navbar-light-active-color",
"navbar-dark-brand-color": "$navbar-dark-active-color",
"navbar-dark-brand-hover-color": "$navbar-dark-active-color",
"dropdown-min-width": "10rem",
"dropdown-padding-y": "0.5rem",
"dropdown-spacer": "0.125rem",
"dropdown-font-size": "$font-size-base",
"dropdown-color": "$body-color",
"dropdown-bg": "$white",
"dropdown-border-color": "rgba($black, 0.15)",
"dropdown-border-radius": "$border-radius",
"dropdown-border-width": "$border-width",
"dropdown-inner-border-radius": "subtract($dropdown-border-radius, $dropdown-border-width)",
"dropdown-divider-bg": "$gray-200",
"dropdown-divider-margin-y": "$nav-divider-margin-y",
"dropdown-box-shadow": "0 0.5rem 1rem rgba($black, 0.175)",
"dropdown-link-hover-color": "darken($gray-900, 5%)",
"dropdown-link-active-color": "$component-active-color",
"dropdown-link-active-bg": "$component-active-bg",
"dropdown-item-padding-y": "0.25rem",
"dropdown-item-padding-x": "1.5rem",
"pagination-padding-y": "0.5rem",
"pagination-padding-x": "0.75rem",
"pagination-padding-y-sm": "0.25rem",
"pagination-padding-x-sm": "0.5rem",
"pagination-padding-y-lg": "0.75rem",
"pagination-padding-x-lg": "1.5rem",
"pagination-line-height": "1.25",
"pagination-color": "$link-color",
"pagination-bg": "$white",
"pagination-border-width": "$border-width",
"pagination-border-color": "$gray-300",
"pagination-focus-box-shadow": "$input-btn-focus-box-shadow",
"pagination-focus-outline": "0",
"pagination-hover-color": "$link-hover-color",
"pagination-hover-bg": "$gray-200",
"pagination-hover-border-color": "$gray-300",
"pagination-active-color": "$component-active-color",
"pagination-active-bg": "$component-active-bg",
"pagination-active-border-color": "$pagination-active-bg",
"pagination-disabled-color": "$gray-600",
"pagination-disabled-bg": "$white",
"pagination-disabled-border-color": "$gray-300",
"jumbotron-padding": "2rem",
"jumbotron-color": "null",
"jumbotron-bg": "$gray-200",
    "card-spacer-y": "0.75rem",
    "card-spacer-x": "1.25rem",
    "card-border-width": "$border-width",
    "card-border-color": "rgba($black, 0.125)",
    "card-inner-border-radius": "subtract($card-border-radius, $card-border-width)",
    "card-cap-bg": "rgba($black, 0.03)",
    "card-cap-color": "null",
    "card-height": "null",
    "card-color": "null",
    "card-bg": "$white",
    "card-img-overlay-padding": "1.25rem",
    "card-group-margin": "$grid-gutter-width / 2",
    "card-deck-margin": "$card-group-margin",
    "card-columns-count": "3",
    "card-columns-gap": "1.25rem",
    "card-columns-margin": "$card-spacer-y"

Roadmap

  • Extending The Library Walk-Thru

About

The OBE:BS4 Design System is the world's first self-reflexive design system for web production.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published