npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@knighttower/bootstrap-mini

v0.1.43

Published

Abstracted Bootstrap for utility prototypes

Downloads

986

Readme

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

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';
npm install knighttower
@import '~knighttower/bootstrap-mini/src/bootstrap-mini.scss';

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;
$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) {
        // only applies to 992px and up
    }
    @include breakpoint(mobile) {
        // only applies to 0-599 px
        // rules
    }
    @include breakpoint(mobile, landscape) {
        // only applies to 0-599 px in landscape
        // rules
    }
    @include breakpoint(200, 'max-width:800px') {
        // only applies to 0-800 px
        // rules
    }
    @include breakpoint(200, 800) {
        // only applies to 0-800 px
        // rules
    }
    //advance
    @include breakpoint(200, 800, true) {
        // negates the query, like "not"
        // 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()

// /**
// * 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)  

// /**
// * ensure the is a px unit
// * @param {String|Number} $value
// * @return {String} {value}px
// */
@function ensure-px($value)  

  • 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.
    • .hr: horizontal ruler.
    • .img: responsive images.
    • ..max-div-width: max width for a div. min 320px, max 1200px.

Automatic rules added rules:

  • img: responsive images
  • hr: horizontal ruler 1px dashed #ccc
  • svg: responsive svg images and maintain aspect ratio
  • hr: horizontal ruler 1px dashed #ccc
  • --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;
  • --x-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.