A minimal, responsive, style-agnostic CSS framework!

css css-framework framework front-end frontend mini responsive sass sass-framework web-development

Find a file

Angelos Chalaris 06bf1e420a Update CHANGELOG.md		2018-08-04 09:31:03 +03:00
dist	Final cleanup	2018-05-28 12:45:21 +03:00
docs	Removed extraneous '>' from Forms & input section	2018-07-18 14:58:45 -05:00
src	wrong var for webkit progress bar background	2018-06-02 17:34:13 +02:00
.gitignore	Tried and tested flavor generation	2018-05-28 12:36:08 +03:00
.npmignore	Package setup updates	2017-06-05 11:59:33 +03:00
bower.json	Update bower.json	2017-11-07 11:08:03 +07:00
CHANGELOG.md	Update CHANGELOG.md	2018-08-04 09:31:03 +03:00
CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md	2017-06-19 15:57:05 +03:00
CONTRIBUTING.md	Create CONTRIBUTING.md	2017-06-19 16:07:05 +03:00
ISSUE_TEMPLATE.md	Update ISSUE_TEMPLATE.md	2017-10-24 13:06:15 +03:00
LICENSE	Toolchain and environment update	2017-03-29 20:59:51 +03:00
package-lock.json	v3	2018-05-28 13:22:17 +03:00
package.json	v3	2018-05-28 13:22:17 +03:00
README.md	fix a broken link	2018-07-18 16:08:09 -07:00

README.md

mini.css

A minimal, responsive, style-agnostic CSS framework

mini.css is a lightweight CSS framework (under 7KB gzipped) designed with mobile devices and modern browsers in mind. Responsiveness, ease of use and customization are some of the main features of the framework, while accessibility and extensive documentation are some of the secondary focuses of the project. The framework is written using Sass, while most of its components are based on Flexbox.

Setup & usage

You have 4 options when it comes to setting up mini.css:

Use a package manager (recommended)
Use GitCDN
Use Rawgit
Use cdnjs (preferred for older releases)

For instructions on how to use, best practices, templates and other usage information, please visit the framework's documentation.

Method 1: Use a package manager (recommended)

Install mini.css using npm, yarn or bower.

npm install mini.css
yarn add mini.css
bower install mini.css

Pick one of the available flavors and use its CSS file.
Start working on your project. Detailed documentation is available on the framework's website, so be sure to check it out.

Method 2: Use GitCDN

mini.css is also hosted on GitCDN, an open-source service, so you can easily grab the latest release's distributables. Simply link to your preferred flavor inside your HTML page's <head> tag:

<link rel="stylesheet" href="https://gitcdn.link/repo/Chalarangelo/mini.css/master/dist/{mini-flavor}.css" />

Remember to replace {mini-flavor} with the flavor's name (e.g. mini-default or mini-default.min for the default flavor).

Method 3: Use RawGit

mini.css is also hosted on RawGit, another open-source service, so you can easily grab a specific release's distributables. Simply link to a release and your preferred flavor inside your HTML page's <head> tag:

<link rel="stylesheet" href="cdn.rawgit.com/Chalarangelo/mini.css/{release-tag}/dist/{mini-flavor}.css" />

Remember to replace {release-tag} with a release from the Releases page and {mini-flavor} with the flavor's name (e.g. mini-default or mini-default.min for the default flavor).

Method 4: Use cdnjs (preferred for older releases)

If you would rather use an older version of the framework, you should head over to cdnjs for a list of releases and flavor files supplied with them.

Flavors & customizaton

Flavors are one of the key features of mini.css, allowing you to customize your website's design and make your project stand out. We provide you with a few pre-defined flavors that might suit your needs and will help you figure out how to use the framework and create websites and apps with it.

But you can easily build you own flavors by using our flavor generator tool, which allows you to customize almost everything. Take your time and create the perfect flavo to suit your needs.

Contributing

Have you found a bug in the framework? Do you want to request a new feature or suggest a new flavor? Maybe found some documentation that is unclear or incomplete? Open an issue and we will be with you shortly.
Have you developed a new flavor and want to share it with the world? Open an issue about it, so that we can link to your repository from the framework's documentation and let the world know. We will try to keep you posted on any new releases coming, so that you can update your flavor as necessary.
Have you developed a module for the framework? Well, we don't really accept new modules right now, but if it works, we will certainly tell people that it's available. Open an issue about it and we will figure it out together.

Maintainers & contributors

The team behind mini.css is as follows:

Angelos Chalaris (@chalarangelo) - Sass archmage, project manager

Special thanks to these fine folks for helping in the development of mini.css:

@tphecca - Author of the Nord flavor
Per Harald Borgen - Introductory video creator
Rory Primrose (@roryprimrose) - Code restructure
Sandro Magi (@naasking) - Multiple suggestions, ideas, bug reports
Wade Garrett (@wad3g) - Multiple fixes for issues and bugs

License

mini.css is an open-source framework and is licensed under the MIT License.