Skeleton SASS

Skeleton SASS is a "SASSification" of Dave Gamache's Skeleton CSS responsive front-end framework.

• .scss and .sass syntaxes available
• compass versions available
• Ability to seamlessly adjust grids
  • Fixed Grid (default)
  • Fluid Grid
  • Adjust columns and gutters
• Install Skeleton SASS with bower! bower install skeleton-sass
• Live demo!
• Extensive documentation

TL;DR

Skeleton SASS is a SASS port of Skeleton CSS. Skeleton SASS is primarily written and debugged using the newer "SassyCSS" syntax of SASS which is seen via the .scss file extension. If you are familiar and/or prefer the older HAML-style syntax then fret not, we offer this syntax as well which is seen via the .sass file extension.

If you are new to SASS altogether then please read our wiki for a more in-depth look at Skeleton SASS, information regarding installing ruby and SASS, and many other valuable resources!

If you have used Skeleton CSS and you are tired of dealing with vanilla CSS, then transitioning to Skeleton SASS will require minimal effort. Since Skeleton SASS is built to duplicate the file hierarchy of Skeleton CSS. This allows the transition to be smooth and painless.

If you have tried other SASS ports of Skeleton CSS you've probably seen a ports that are built inefficiently, inaccurately, and perhaps even downright poorly. Skeleton SASS will be the last time you search for a SASS port of Skeleton CSS. With only three additional files to satisfy dependencies, this will allow you to easily transition into using Skeleton SASS. Continue reading about each of the files that are used by Skeleton SASS.

Features

1. Duplicates the exact file hierarchy, file structure, and file names as Skeleton CSS
2. Separation of variables, functions, and mixins to keep code clean and DRY
3. Compass and Non-Compass versions available
4. .sass and .scss versions available
5. Install Skeleton SASS with bower front-end package manager

Project Organization

Skeleton SASS is organized into two major categories:

1. Compass Version
2. Non-Compass Version

Both of these versions are organized the same exact way to ensure maximum usability:

• bourbon
  • core
    • Bourbon source files
  • _loader.scss
  • _dependencies.scss
  • _mixins.scss
  • _functions.scss
  • _vars.scss
  • _config.scss
  • base.scss
  • layout.scss
  • skeleton.scss
• compass (Compass Version)
  • scss
    • _dependencies.scss
    • _mixins.scss
    • _functions.scss
    • _vars.scss
    • • _config.scss
    • base.scss
    • layout.scss
    • skeleton.scss
• sass (Non-Compass Version)
  • scss has the same files as compass

File Overview

• skeleton contains the core of the framework. This file contains the responsive goodness among other structural styles and is required for the framework to be used.
• layout is an optional file where you can add custom styles that may extend the framework and/or custom styles for your website. You may discard this file if you wish.
• base is an optional file which contains the default styles for the framework. You may discard this file if you wish.
• _mixins is a partial file that contains all of the high-level core mixins used in the framework which means this file is required. Additionally, you may add your own custom mixins at the top of this file as well as edit existing mixins to suit your needs. See this file for additional information.
• _dependencies is a partial file that contains core functions and "private" mixins that aren't meant to be used directly. Avoid editing this file directly unless you know what you're doing! The framework will not work if you delete this file.
• _vars is a partial file which is required because it contains all of the global variables for the framework. See file for additional information.
• _functions is a partial file where you may add custom functions. This file is not required by any means and may be discarded if you wish.
• _config.scss is a partial file that houses all local configuration information that you do not wish to be overridden by bower. Git users be warned as if you are doing a fresh pull, git will still override this file!

Bower

Bower is a package manager for the web. It offers a generic, unopinionated solution to the problem of front-end package management, while exposing the package dependency model via an API that can be consumed by a more opinionated build stack. There are no system wide dependencies, no dependencies are shared between different apps, and the dependency tree is flat — bower.io

For more info on bower, checkout bower.io.

Skeleton Sass is now available on Bower because we want to make your life easier. You can now add Skeleton Sass to any project easily by issuing bower install skeleton-sass.

Demo

Live demo can be seen here: http://atomicpages.github.io/skeleton-sass. Be sure to resize your browser window and see the responsive goodness in action!

Want to see spin on the default 16-column fixed-grid system? See the demo here!

Documentation

Skeleton SASS is heavily documented! If you're looking for a detailed description (or just want more info) you can checkout the wiki pages!

Resources

• Installing SASS
• Installing Compass
• Setting up a Fluid Grid

Documentation

• Introduction to Skeleton SASS
• Function Documentation
• Variable Documentation
• Mixin Documentation

License

This project is released under the MIT license. Who doesn't like free code?

Find a Bug?

Skeleton SASS is community driven. We will gladly review any issues that you find. If you wish to contribute you'll land a spot in the contributions section of this document!

I Found a Bug/How Can I Help?

• Create an Issue
• Fork & Pull

Changelog

1.6.2

• Added local configuration file that won't be overridden when updating with bower.
• Updated bower.json to exclude demo and development files from being installed with bower

1.6.1

• Fixed missing one-third and two-thirds selectors in fluid grid
• Updated 12, 20, and fluid CSS files in css directory

1.6.0

• Added support for Bourbon
• Revised _fluidGrid mixin to utilize Sass functions
• Resolved spelling errors in numToString function
• Revised _fixedGrid mixin
• Resolved Issue #11
• Cleaned up fluid grids for tablets by removing redundant code
• Fixed 1.5.0 documentation in the README
• Finally updated the bower version number so bower users can actually upgrade
• Removed .sass files, use sass-convert -R my_css_dir --from css --to scss

1.5.3

• Added the following HTML5 input types to inherit default styles in base.css
  • date
  • datetime
  • datetime-local
  • week
  • number
  • month
  • time
• Updated test.html to accommodate these updated types as well as these input types:
  • color

1.5.2

• Fixed quote issue on transitionn mixin for non-compass version

1.5.1

• Resolved issue #9

1.5.0

• Commit fixes issue #7. You no longer need to manually calculate $colWidth in the grid mixin!
• Resolved spelling error: .two-third.column changed to .two-thirds.column

1.4.2

• Added vanilla CSS component to Skeleton SASS. You can now have CSS right out of the box without having to compile any sass code!
• Added additional files and folders for bower to ignore

1.4.1

• Added Skeleton SASS to bower! You can now drop Skeleton SASS into your projects using bower install skeleton-sass

1.4.0

• Moved contents from _functions to a new partial called _dependencies
• Moved all of the "private" mixins to _dependencies partial since these are core mixins and functions
• Finally added offset styles to mobile grids – I realize that was a major piece that was missing
• Added mobileGrid mixin
• Added the following mixins to the non-compass version:
  • single-transition
  • transition
  • reset-font
  • reset-focus
  • reset-list-style
  • reset-table
  • reset-table-cell
  • reset-quotation
  • reset-image-anchor-border
  • reset-html5
  • global-reset
  • nested-reset
• Non-compass version gradient support is available but these mixins still need multi-stop support
  • filter-gradient - this is for IE only and works 100%
  • linear-gradient - produces a linear gradient in all directions
  • radial-gradient - produces a radial gradient
• Removed redundant code for .container .columns margins
• Fixed offset calculation issue for fluid grid
• Added support for grouped selectors on mobileGrid

1.3.4

• Added sample outline of a web page to show a more realistic example of how the page will scale

1.3.3

• Oops! The demo has now been fixed!

1.3.2

• Updated README file and fixed demo files so it actually works this time ;)

1.3.1

• Removed unnecessary if statement at the top of the numToString function

1.3

• Greatly improved int to string conversion by using something other than a million if-else statements

1.2.3

• Cleaned up .sass files by using tabs instead of default 2 spaces
• Fixed gutter calculation on fixed grid and in the skeleton file
• Used boolean in _fluidGrid to prevent sass-convert from stripping null value

1.2.2

• Added support for fluid grid generation based on column number
• Cleaned up headers
• Housekeeping in _mixins file
• Fixed issue in .sass files. null type being stripped when using sass-convert --from scss --to sass

1.2.1

• Fixed Duplicate .container on offsets

1.2

• Addition of fluid grid :)
• Complete restructure of mixins file and grid generation
• Changed name of makeGrid mixin to grid
• Changed core variable names. See vars for more information
• Cleaned up headers across the board
• Removed unnecessary and unused functions
• Separated roles in mixins file
• Cleaned up comments in all files
• and more...

1.1

• Update to several functions and mixins.
• Addition of new variables
• Several fixes for non-compass version
• Fixing of .sass files

Authors

• Dennis Thompson
• AtomicPages LLC

Contributors

• Jackson Hines
• robertosobachi
  • Issue #6
  • Pull #10
• vephinx:
  • Issue #7
  • Issue #9