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 e0b1e1fb10 Updated documentation, resolves #64 Used a localized copy of the flavor file to style all the doc pages, added a few things wherever needed, added all download options, updated the README.		2017-04-18 14:27:39 +03:00
dist	Documentation for new flavors	2017-04-18 13:24:39 +03:00
docs	Updated documentation, resolves #64	2017-04-18 14:27:39 +03:00
src	Documentation for new flavors	2017-04-18 13:24:39 +03:00
.gitignore	Toolchain and environment update	2017-03-29 20:59:51 +03:00
.npmignore	Toolchain and environment update	2017-03-29 20:59:51 +03:00
bower.json	Toolchain and environment update	2017-03-29 20:59:51 +03:00
CHANGELOG.md	Toolchain and environment update	2017-03-29 20:59:51 +03:00
LICENSE	Toolchain and environment update	2017-03-29 20:59:51 +03:00
package.json	2.1.0	2017-02-16 21:01:02 +02:00
README.md	Updated documentation, resolves #64	2017-04-18 14:27:39 +03:00

README.md

mini.css v2.1.1

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 either from npm or bower.

npm install 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 editing a flavor file and customizing almost everything. For more information, head over to the Customization page and build your own flavor the way you like it.

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:

Angeliki Daskalakis (@angiedaskalakis) - Author of the Sucroa flavor
Rory Primrose (@roryprimrose) - Code restructure
Sandro Magi (@naasking) - Multiple suggestions, ideas, bug reports

License

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