Giter Club home page Giter Club logo

groundwork's Introduction

Groundwork Logo

GroundworkCSS 2.4.0

Say hello to responsive design made easy.

http://groundworkcss.github.io

GroundworkCSS is a fully responsive HTML5, CSS and Javascript toolkit created by @ghepting.

Using GroundworkCSS, you can rapidly prototype and create accessible web apps that work on virtually any device. Key features that make GroundworkCSS stand out are:

  • nestable, fractional, responsive, adaptive, fluid grid system
  • works on virtually anything: mobile, tablet, or large screen devices
  • built with modular SCSS and JS components
  • easy to customize
  • highly configurable
  • supports purely semantic implementations by utilizing Sass @extend, @mixin and %placeholder classes
  • built-in ARIA role support
  • responsive text and tables
  • and much more

Getting Started using GroundworkCSS

Default Build

The easiest way to incorporate GroundworkCSS into your project is to copy the pre-compiled CSS and JS files into your project, and then refer to them in markup. The 2 most important files are:

  • css/groundwork.css
  • js/groundwork.all.js

In addition to these (required) support files:

  • js/libs/modernizr-2.6.2.min.js (required)
  • js/libs/jquery-1.10.2.min.js (required)
  • css/groundwork-ie.css (required for old IE compatibility)

All in all, you may end up with markup that looks like the following:

At the top of your HTML document (within the head section)

<!-- Modernizr -->
<script src="/js/libs/modernizr-2.6.2.min.js"></script>
<!-- framework css -->
<!--[if gt IE 9]><!-->
<link type="text/css" rel="stylesheet" href="/css/groundwork.css">
<!--<![endif]-->
<!--[if lte IE 9]>
<link type="text/css" rel="stylesheet" href="/css/groundwork-core.css">
<link type="text/css" rel="stylesheet" href="/css/groundwork-type.css">
<link type="text/css" rel="stylesheet" href="/css/groundwork-ui.css">
<link type="text/css" rel="stylesheet" href="/css/groundwork-anim.css">
<link type="text/css" rel="stylesheet" href="/css/groundwork-ie.css">
<![endif]-->

At the bottom of your HTML document (just before your closing body tag)

<script type="text/javascript" src="/js/libs/jquery-1.10.2.min.js"></script>
<script type="text/javascript" src="/js/groundwork.all.js"></script>

Custom Build

If you use SCSS and you want to compile your own build of Groundwork or integrate it along with your project code.

SCSS source files are located in src/scss and src/coffee.

Important files to edit are:

  • groundwork.scss: dictates which modules are imported for compilation (delete/comment out unneeded modules).
  • _settings.scss: initial settings for Groundwork, including customizable colors, options to turn off rapid prototyping classes and much more.

You can then output your own groundwork[.css/.js], or import groundwork.scss as part of your project's SCSS. The latter lets you utilise GroundworkCSS's library through @include or @extend for your custom classes.

Ruby on Rails

If you're using Groundwork in a Ruby on Rails project, definitely use the groundworkcss-rails gem

Want to develop on and contribute to GroundworkCSS?

Read Contributing to Groundwork and fork away! :)

groundwork's People

Contributors

ghepting avatar sethta avatar pocesar avatar rwetzlmayr avatar puchesjr avatar geoffreycrofte avatar ivanovyordan avatar nertzy avatar p-j avatar ldewald avatar xinix avatar geekatwork avatar chandranshu12 avatar

Watchers

James Cloos avatar tongchuan avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.