Skip to content

20minutes/colette

Folders and files

NameName
Last commit message
Last commit date
Dec 15, 2021
Oct 4, 2019
May 30, 2023
Aug 2, 2018
Oct 4, 2019
Sep 16, 2021
Apr 25, 2019
Nov 19, 2019
Apr 24, 2018
Jul 3, 2018
Aug 24, 2016
Mar 2, 2020
Sep 16, 2021
Oct 27, 2017
Sep 10, 2019
Oct 4, 2019
Feb 28, 2020
Sep 25, 2024
May 30, 2023
Nov 22, 2019
Feb 4, 2022

Repository files navigation

Introducing Colette

Colette is a CSS and JS starter kit for 20 Minutes web projects. It provides basic styles and mixins to build responsive layouts, based on the 20 Minutes digital identity guidelines.


Features

  • basic typography: headings, body text, lists, etc.
  • helpers: colors, borders, icons, etc.
  • grid system: 12-columns based, with customizable breakpoints
  • ready-to-use HTML/CSS components: buttons, navbar, socialbar, content teasers, media, and loading animation

Dependencies


Installation

With npm (recommended)

npm install colette --save

Download

  • See the dist/ directory for ready-to-use CSS files.
  • If you want to use Colette as a kickstarter for custom stylus/css projects, check src/.

Use Colette’s styles from Stylus sources

You can use colette.css as is (or minified files colette.min.css).

But the best way to use Colette is by Stylus and JavaScript sources with a task-runner (ex: gulp, webpack).

Use gulp

To compile your stylus, use gulp and gulp-stylus

/* gulpfile.js */
gulp.task('css', function () {
   return gulp.src(cfg.cssDir + '*.styl')
   .pipe(stylus({
        include: [
            PATH_TO_STYLUS_IMPORT,
            AN_OTHER_PATH_TO_FIND_STYLUS_MODULES
        ],
        'include css': true
    }))
   .pipe(gulp.dest('css/'))
})

PATH_TO_STYLUS_IMPORT could be node_modules for example if you use npm.

Use webpack

To compile your stylus, use stylus-loader

/* webpack.config.js */
{
  test: /\.styl$/i,
  use: [
    'style-loader',
    'css-loader',
    'postcss-loader',
    {
      loader: 'stylus-loader',
      options: {
        paths: [
          'node_modules',
        ],
        'include css': true,
        'resolve url': true,
        stylus: {
          preferPathResolver: 'webpack',
        },
      },
    },
  ],
}

Partial import

Colette is a collection of stylus features. You can define which styles you want to include into your final CSS file with stylus import.

By default, you include all colette.styl and all features are in your CSS. You can select features needed by copying colette.styl content and choose your imports rules.

/* my_css_file.styl */

// Your own settings

// Import colette
@require 'colette/assets/styl/colette'

/* => will compile to my_css_file.css */

But can be usefull to:

  • change order of imports,
  • import only needed features,
  • separate your critical CSS from your global CSS.

Use Colette’s JavaScript from sources

You can use colette.min.js as is.

But the best way to use it is with a task-runner by JavaScript sources (ex: gulp, webpack).

You should use babel to transpile colette code to Javascript for Browsers.