How do I install & use it?

Run bower install egg-scss from where you want to use it (I usually rename bower_components/ to vendors/).
Call egg with @import 'vendors/egg/egg'; for example.
Override variables (colors, font sizes, spacing...). Check the _variables.scss file for more info. In particular, pay attention to the $partials variable.

What is egg?

egg was built as an alternative to the many CSS/SASS frameworks out there; Foundation, Bootstrap and the likes. It intends to be minimalistic, solving as few problems as possible and providing developers with the basic defaults and mixins to solve the problems they experience designing their Web apps and websites.

It was designed with two core principles in mind;

Don't dictate HTML; while we do provide some defaults, we mostly provide mixins for users to decide how they want to associate style and markups rather than specific (and often heavy) classes and HTML structure.
Don't solve too many prolems; we focused on the few things that we think are difficult or important when building for the Web; typography, modals, forms... The rest is best solved by developers for their specific use case.

Examples

If you use egg's defaults, you get a certain amount of styles and elements out of the box. The kitchen sink should help you explore the available styles and illustrate how you use them:

Typography

This is a headline 1

And a headline 2

And finally a headline 3

This text last title is followed by a regular paragraph.

Buttons

Notifications

Default notification

Info notification

Success notification

Warning notification

Error notification

Form

Table

Name	Location	Email
Paul Lambert	Paris, France	paul@example.com
John Smith	New York, USA	john@example.com
Chen Wang	Shanghai, China	chen@example.com