@knighttower/bootstrap-mini

Bootstrap Mini

Built on top of Bootstrap but modified to have only the basic utilities classes and the grid system. This is a (very) lightweight CSS version that can be used to build websites and web applications.
It is not meant to replace the full functionality of Bootstrap, only to abstract the basic utilities to use in quick prototypes, small projects or to compliment other frameworks since it does not add any root styles, resets or normalize, colors or other theme styles that would override or conflict. It can also be customized with a few variables before importing the file to load only a few utilities or the full set.
Out the box it can be used from the cdn but to further reduce the size, it can be installed as a node module and imported as a sass file to be compiled with postcss.
Compressed: 70 KiB
Uncompressed: 104 KiB
GZip: 8 KiB
Brotli: 5 KiB

Usage (stand-alone):

npm install @knighttower/bootstrap-mini -D

@import '~@knighttower/bootstrap-mini/dist/bootstrap-mini.css';

Or to use the sass file, and use the sass functions and utilities:

@import '~@knighttower/bootstrap-mini/src/bootstrap-mini.scss';

Usage (monorepo):

npm install knighttower

@import '~knighttower/bootstrap-mini/src/bootstrap-mini.scss';

or as a drop-in css file into vite or webpack ``` import "@knighttower/bootstrap-mini/dist/bootstrap-mini.css" ```

If using the sass file, some variables are available to be modified before importing the file. These are the defaults

$miniPrefix: bs-;
$miniColumns: 12;
$miniGutterWidth: 1.5rem;
$miniRowColumns: 6;
$miniFontSizeBase: 1rem;

$miniEnableMargins: true;
$miniEnablePadding: true;
$miniEnableWidth: true;
$miniEnableHeight: true;
$miniEnableZIndex: true;
$miniEnableFlex: true;
$miniEnableFloat: true;
$miniEnablePosition: true;
$miniEnableDisplay: true;
$miniEnableVisibility: true;
$miniEnableContainer: true;
$miniEnableGridClasses: true;
$miniEnableCssGrid: true;

Then do:

$miniEnableMargins: false;  
//... other overrides before the import  
@import '~@knighttower/bootstrap-mini/src/bootstrap-mini';  

It includes

• Width
• Height
• Z-index
• Flex
• Flexbox
• Grid
• CSS grid
• Spacing
• Columns
• Position
• Display
• Sizing
• Margin
• Padding
• Float
• Clear
• Utilities
• Mixins

Note: standard bootstrap variables for the modules included are also possible to be used. Ex: $container (for the container module), $grid-gutter-width (for the grid module), etc...

It does not include

• No javascript
• No images
• No fonts
• No icons
• No javascript plugins
• No components
• No animations
• No transitions
• No colors
• No themes
• No resets
• No negative margins or paddings
• No negative width or height
• No negative z-index
• No buttons
• No forms
• No tables
• No typography
• No print styles

--> Told ya! It's tiny!

Features and Utilities included

• Cool set of mixins (in addition to the bootstrap default ones)

/**
* @mixin breakpoint
* BreakPoint print utility
* @param {String} $screen <breakdown name>|size in px
* @param {Null|String} $param Keywords:landscape, portrait|<custom query>ex:max-width:800px
* @param {Null|Bool} $exclude null | true to negate the query use with caution.
* @return Media Query
* @example
* @include breakpoint(<breakdown name>){rules...}; or
* @include breakpoint(000px,'max-width:800px'){rules...}; or
* @include breakpoint(<breakdown name>,landscape){rules...}; or
* @include breakpoint(<breakdown name>,'max-width:800px'){rules...};, etc...
* @example
* @include breakpoint(mobile){rules...}; or
* @include breakpoint(000px,'max-width:800px'){rules...}; or
* @include breakpoint(mobile,landscape){rules...}; 
* Includded breakpoints: mobile, phone, 320, 480, 520, tablet, 600, 700, odd, 800, desktop, desk, 920, 1000, 1200, 1440, 1600, fullscreen, nondesktop, sm, md, lg, xl, xxl  
*/
.ex-class {
    @include breakpoint(lg) {
        // rules
    }
    @include breakpoint(mobile) {
        // only applies to 0-599 px
        // rules
    }
}


// /**
// * Merge maps
// * @param {Array} $maps Array or list of Arrays of maps to merge
// * @return {Array}
// * @example
// * $button-group: ($base-hiearchy, $base-states, $shared-states);
// * $buttons: mapMerge($button-group);
// */
@function mapMerge($maps...) {
    $m: ();

    // Check if single list of lists
    @if type-of(nth($maps, 1)) == "list" and length($maps) == 1 {
        @each $map in nth($maps, 1) {
            $m: map-merge($m, $map);
        }
    }
    // Multiple parameters
    @else {
        @each $map in $maps {
            $m: map-merge($m, $map);
        }
    }

    @return $m;
}

:root {
    --bs-disabled-bg: #e9ecef;
    --bs-disabled-text: #6c757d;
    --bs-disabled-border: #c8cbcf;
    --bs-disabled-line: #6c757d;
}
// /**
// * @mixin disabled
// * Add "disabled" state to an element
// * @return {String}
// * @example
// * // .class{ @include disabled();}
// */
@mixin disabled() {
    &,
    &:hover {
        background: var(--bs-disabled-bg);
        color: var(--bs-disabled-text);
        border-color: var(--bs-disabled-border);
        position: relative;
    }

    &:before {
        position: absolute;
        height: 1px;
        width: 100%;
        top: 50%;
        left: 0;

        display: block;
        border-bottom: 1px solid var(--bs-disabled-line);
        content: " ";
        transform: rotate(15deg);
    }

    &:hover {
        cursor: not-allowed;
    }
}

// /**
// * add transition effect to an element
// * @mixin transitionProp
// * @param {String} $property Property name
// * @param {Number} $duration 0.5s
// * @param {String} $method ease
// * @param {Number} $delay 0s
// * @return {String}
// * @example
// * // .class{ @include transitionProp(all, 0.5s, ease, 0s);}
// */
@mixin transitionProp($property, $duration: 0.5s, $method: ease, $delay: 0s) {
    transition: $property $duration $method $delay;
    -moz-transition: $property $duration $method $delay;
    -webkit-transition: $property $duration $method $delay;
    -o-transition: $property $duration $method $delay;
}

## Specific classes

• A set of utility classes that can be used to build websites and web applications. Only the most used classes are included. The rest can be added by the user.

  -- Common Bootstrap classes:
  --- Flex, Flexbox, Grid, Spacing, Text, Display, Position, Visibility, Sizing, Margin, Padding, Css grid, Columns

• Modified classes:
  -- ml (margin-left), mr (margin-right), pr (padding-right), pl (padding-left), float-left, float-right

• Additional classes:
  -- Width (w-) increments in 10, ex: w-10, w-20, w-30, etc... up to 100%
  --- Widht special: w-25, w-33, w-50, w-66, w-75, w-100 (25%, 33%, 50%, 66%, 75%, 100%)
  -- Height (h-) increments in 10, ex: h-10, h-20, h-30, etc... up to 100% and 'vh' for viewport height
  -- Zindex (z-) increments in 10, ex: z-10, z-20, z-30, etc... up to 50

• Screen Sizes:
  -- mobile: 0-599px (targets only this braket)
  -- tablet: 600-1023px (targets only this braket)
  -- desktop: 1024 (targets from here up)
  -- sm: 576 (targets from here up (bootstrap default behavior))
  -- md: 768 (targets from here up (bootstrap default behavior))
  -- lg: 992 (targets from here up (bootstrap default behavior))
  -- xl: 1200 (targets from here up (bootstrap default behavior))
  -- xxl: 1400 (targets from here up (bootstrap default behavior))
  
  Utils:
  
  

  • .--nounderline: Removes text underline.
  • .--underline: Adds text underline.
  • .--titlecase: Capitalizes the first letter of each word.
  • .--uppercase: Converts text to uppercase.
  • .--italic: Applies italic style to text.
  • .--normal: Resets text transform to none.
  • .--nowrap: Prevents text wrapping.
  • .--no-wrap: Prevents text wrapping (duplicate of .--nowrap).
  • .--wrap: Allows text wrapping.
  • .--bold: Applies bold weight to text.
  • .--text-left: Aligns text to the left.
  • .--text-right: Aligns text to the right.
  • .--text-center: Centers text.
  • .--text-justify: Justifies text.
  • .list: list style.
  • .list--inline: list style inline.
  • .list--unstyled: list style unstyled.
  • .spacer: makes a div into a spacer. sizes are added as classes, ex: .spacer --10, .spacer --20, etc...

Automatic rules added rules:

• img: responsive images
• hr: horizontal ruler 1px dashed #ccc
• svg: responsive svg images and maintain aspect ratio

## Root vars

• --bs-disabled-bg: #e9ecef;
• --bs-disabled-text: #6c757d;
• --bs-disabled-border: #c8cbcf;
• --x-body-color: #212529;
• --x-body-bg: #fff;
• --x-ul-padding: 7px 0 10px 20px;
• --x-base-font-size: 1;
• --x-base-line-height: 1.5;
• --x-font-size: 15px;
• --x-base-div-width: 1040;
• --input-height: 40px;
• --bs-gutter-x: 1.5rem;
• --bs-gutter-y: 0;

max container width

• --bs-max-width: 100%;
• --bs-max-width-lg: 1024px;
• --bs-max-width-xl: 1200px;
• --bs-max-width-xxl: 1400px;
• --bs-container-pad-xs: 15px;
• --bs-container-pad-sm: 20px;
• --bs-container-pad-md: 30px;
• --bs-container-pad-lg: 40px;
• --bs-container-pad-xl: 40px;
• --bs-container-pad-xxl: 40px;

Gotchas

• when using the @import in a sass file, make sure to use the tilde (~) to point to the node_modules folder and add resolvers to the 'node_modules' folder in the sass-loader configuration in webpack or vite.

Why?

Most CSS frameworks come loaded with themes, or bulky in general that makes it hard the quick use without getting the full package or having to modified them to get only what you need. I also (IMO) think that the grid system bootstrap offers, has simple and versitile enough to be used in quick projects. (I'll discuss that in a future post).
Please notice, that there are things that are not included in this tyny version, the intention of this it to be basic, and if more functionality is needed, or theme styles need to be applied, then you should go full framework with Bootstrap [https://getbootstrap.com], Tachyons [https://tachyons.io], unoCSS [https://unocss.dev] (I have my eye on this one), etc...

PS: as of the writting of this, I have been implementing the minibootstrap (only the grid and cssgrid) along with UnoCss and this is a killer combo. (notice that UnoCss does not provide a strong grid but bootstrap does). I'll talk about this more at https://knighttower.io

Credits to the Bootstrap team for the great work they have done.