# Download

Learn where to download and how to compile the Uimini sources.

Here's ways how you can download uimini:

# CDN

Not available yet. We need to have 100+ start on github (opens new window) for start to use CDN. Help us to make it πŸ˜ƒ

# Compiled CSS

Download ready-to-use compiled code for Uimini v2.0.5 to easily drop into your project

This doesn’t include configs, scss source file.

Download Compiled CSS

Content:

uimini/
β”œβ”€β”€ uimini.css                # default uimini
β”œβ”€β”€ uimini.min.css            # same but .min version
β”œβ”€β”€ uimini_no_reset.css       # uimini without rest (read 'Reset' section bellow for more info)
β”œβ”€β”€ uimini_no_reset.min.css   # same but .min version

# optional build with support old browsers like ie10
# (read 'Legacy browser support' section bellow for more info)
β”œβ”€β”€ ie-10/
β”‚   β”œβ”€β”€ uimini.css
β”‚   β”œβ”€β”€ uimini.min.css
β”‚   β”œβ”€β”€ uimini_no_reset.css
β”‚   β”œβ”€β”€ uimini_no_reset.min.css

# Download source

Compile Uimini with your own asset pipeline by downloading our source Sass. For download last realize with all new feature click here (opens new window) or follow button bellow.

You can also choice specific realize if you need in realizes page (opens new window). All realizes are stable.

Download source

Content:

uimini/
β”œβ”€β”€ dist/
β”‚   β”œβ”€β”€ uimini.css
β”‚   β”œβ”€β”€ ...
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ uimini.scss     # core import
β”‚   β”œβ”€β”€ core.scss       # core styles
β”‚   β”œβ”€β”€ builds/         # build options
β”‚   β”œβ”€β”€ components/     # buttons, inputs, etc
β”‚   β”œβ”€β”€ theme/          # theme config
β”‚   β”œβ”€β”€ typography/     # lists, title, etc
β”‚   β”œβ”€β”€ utils/          # vars, mixains, etc

# Package managers

Pull in Uimini source files into nearly any project with some of the most popular package managers like webpack or gulp.

# NPM

Install Uimini in your Node.js with the npm package (opens new window):

npm install uimini

# Yarn

Install Uimini in your Node.js with the yarn package (opens new window):

yarn add uimini

# Usage Uimini

After installation via npm or yarn pull in Uimini source or dist files into nearly any project with imports or required (depend of package manager).

With webpack: make import of uimini from node_modules inside main entry of webpack (usually it's app.js or index.js):

// Default import uimini:
// will be same as `uimini/dist/uimini.css`
import 'uimini'

// Or import specific file:
import 'uimini/dist/uimini.css'
import 'uimini/dist/uimini_no_reset.css' // Not recommended. Cause inconsistencies across browsers / devices will works incorrect

// Or imports scss core files:
import 'uimini/scr/scss/utils/reset.scss' // reset
import 'uimini/scr/scss/uimini.scss' // core of uimini

# Build From Source

Optionally, you can build Uimini from source on Github (opens new window). To do this, you'll need to have Node.js and npm installed (opens new window).

Build From Source with npm:

git clone https://github.com/uimini/uimini.git
cd uimini
npm install
npm start

Build From Source with yarn:

git clone https://github.com/uimini/uimini.git
cd uimini
yarn && yarn start

# Uimini v1

Since 2020 uimini v1 is not supported. But if you still want to use first version follow one of this options:

Additional links for uimini v1:

# Reset (reboot)

For improved cross-browser rendering, we use Reset by default to correct inconsistencies across browsers and devices while providing slightly more opinionated resets to common HTML elements.

Inside css folder two types of uimini:

  1. uimini.css - reset included (highly recommend to use)
  2. uimini_no_reset.css - Without reset styles (Be careful cause with no_reset option inconsistencies across browsers and devices will works incorrect)

# Legacy browser support

Π‘ss in uimini-ie10 folder builded with: "browserslist": "last 3 versions",

Build size with extra browser support increased by ~22% (from 19kb to 23kb)

# Extra browsers supported:

  • Ie 10 - 11;
  • Firefox 2-21, 22-27 (2006-2012);
  • Chrome 4-20 (2010-2012);
  • Safari iOS 3.2-6.1 (2010-2013);
  • Android browser 2.1-4.3 (2009-2013).

# When to use extra browsers support

For e-commerce, state projects etc.

Summing up: for e-commerce which using jquery and polyfills it's a good solution to use uimini with extra browsers support.

# When NOT TO USE extra browsers support

For example:

  1. If you gonna use Vue.js 3 which not supported ie 11 then you don't need extra browser support.
  2. If you gonna use React.js + Mobx 4+ (also not supported ie 11) then you don't need extra browser support.
  3. When you using es6+ feature without bable and extra polyfills. Cause that's means you don't support old browsers then you don't need extra browser support.

Summing up: if you using modern JavaScript (or modern css like grids) then you don't need uimini with extra browser support.