Inverted Triangle CSS Visualization

ITCSS

GitHub release GitHub issues GitHub last commit Build Status npm npm Analytics

A starter boilerplate based on the ITCSS (Inverted Triangle CSS) methodology.

About

This boilerplate is intented to be used as a starting point in your application. You should use this as a foundation for your CSS and build on top of it.

Install

# Via NPM
npm i itcss

# Via Yarn
yarn add itcss

Usage

If you are using a module bundler (such as Webpack, Parcel, Browserify):

# In your CSS entrypoint
@import 'itcss';

# Or if the above does not resolve, try
@import 'itcss/index.css';

There are several predefined variables which you can overwrite:

:root {
	/* Color Variables */
	--color-base: #333;
	--color-white: #fff;
	--color-black: #000;
	--color-action: #ef4c23;

	/* Text Variables */
	--font-sans-serif: sans-serif;
	--font-serif: serif;
	--font-monospace: monospace;
	--font-size-base: 1rem;
	--line-height-base: 1.35;
	--font-size-h1: 2rem;
	--font-size-h2: 1.75rem;
	--font-size-h3: 1.5rem;
	--font-size-h4: 1.25rem;
	--font-size-h5: var(--font-size-base);
	--font-size-h6: 0.75rem;

	/* Transition Variables */
	--timing: 0.4s;
	--easing: ease-in-out;

	/* Misc Variables */
	--shell-width: 75rem;
}

You should place the overwriting variables after the @import statement.

Supported browsers

This boilerplate is using the most recent version of the CSS specification. In order to support more browsers you must use a tool such as PostCSS. The combined and built version of this boilerplate is using the Postcss-Preset-Env in stage: 0. This means that you can use the most recent CSS features and be sure that they will work older browsers.

The combined and built version of this boilerplate has been tested and works in all evergreen browsers (Chrome, Firefox, Edge, Opera, Safari, Brave, Vivaldi, iOS Safari, Chrome on Android, Samsung Internet) and IE 10+.

In order to do so in your setup, please refer to the postcss.config.js file.

Available CSS selectors and their purpose

Settings

  • _colors.css - contains all colors and theme Settings
  • _text.css - contains all text settings (font-size, font-family, etc)
  • _transitions.css - contains the default transition duration and timing function
  • _variables.css - contains all other variables

Tools

  • _chevron.css - a mixin for a directional arrow icon
  • _flexbox.css - a mixin for flex container
  • _media-queries.css - mixins for all supported media queries
  • _mixins.css - all other mixins

Generic

  • _form-elements.css - default styles for form elements
  • _reset.css - additional browser reset and normalize (normalize.css is also included)
  • _transitions.css - default transitions for focusable/active elements

Elements

  • _document.css - default styles for the body element
  • _headings.css - default styles for all h* (h1 - h6) tags
  • _links.css - default styles for anchors
  • _texts.css - default styles for text elements

Objects

  • _grid.css - a grid system
  • _main.css - styles for the main element
  • _shell.css - styles for the site container
  • _wrapper.css - styles for the site wrapper

Components

  • _btn.css - default styles for the buttons
  • _list.css - default styles for lists

Utilities

  • _align.css - alignment class utilities
  • _fullsize-background.css - helper for background image
  • _hidden.css - helper class/attribute for hidden elements
  • _responsive-utilities.css - helpers for showing/hiding elements on different resolutions
  • _text-align.css - text alignment utilities

LICENSE

MIT