a simple to use, easy to remember css framework
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Add Primary Button to Examples Jun 15, 2017
docs fix Jul 22, 2017
js Remove jQuery, Prefer CDN Mar 17, 2017
sass Add Primary Colour to Map Jun 15, 2017
.eslintrc.json Remove Function Name Setting Mar 16, 2017
.gitignore Figure out mkdocs Jun 12, 2017
CHANGELOG.md Added Release 1.5 Changelog Oct 20, 2015
LICENSE Update License Mar 15, 2017
README.md Update URLs Jun 15, 2017
gulpfile.js Make gulp work with sass Mar 21, 2017
mkdocs.yml Figure out mkdocs Jun 12, 2017
package-lock.json Downgrade Uglify Jun 11, 2017
package.json Update Homepage URL Jun 11, 2017



Join us on Discord

Caramel is a simple, modern, responsive website framework. Caramel is fully responsive, meaning you only need to write code once, to have the same results across multiple platforms. Created by kurisubrooks, Caramel is being developed with help from the open-source community on GitHub.

Getting Started

Quick Start

Jump right into Caramel by using the following HTML5 Boilerplate.

<!doctype html>
<html lang="en">
    <meta charset="utf-8">
    <meta http-equiv="x-ua-compatible" content="ie=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link href="./caramel.min.css" rel="stylesheet">

        <h1>Welcome to Caramel!</h1>
        <p>Your code goes down here!</p>

    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.2.0/jquery.min.js"></script>
    <script src="./caramel.min.js"></script>


What's included?

Our public releases only contain the files that are necessary for front-end development. If you'd like to develop for, or modify Caramel, we'd recommend downloading the Development Build, which includes our build tool, and the sass source files.

├── showcase.html
├── css/
│   ├── caramel.css
│   └── caramel.min.css
└── js/
    ├── caramel.js
    └── caramel.min.js


Head on over to our website, and view the Showcase. All code usage and examples are listed right there on the page! If you want to see the exact syntax we use to show you the content on the page, simply right click on the page and view source (depending on whether your browser supports this feature).

Still stuck or need further help? Tweet @kurisubrooks, and he'll try to answer any questions you may have.


We've included an easy and hassle free way for you to compile Caramel. We've included our own Gulp build tool, that you can use to compile Caramel.


Our compiler runs on Node.js, so before you can continue, please ensure that you have it installed. Once you have Node installed, you'll need Gulp. If you already have both Node and Gulp installed, skip these steps, otherwise install Node.js from their website, then run the following command to install Gulp:

npm install gulp --global

Note: You may need to run this command with sudo on macOS


To get the latest version of Caramel and to install the build tools, run the following set of commands:

git clone https://github.com/caramelcss/caramel.git
cd ./caramel
npm install


To run the build tool, run the following command:


After the build is complete, the output caramel.css, caramel.min.css and caramel.min.js files can be found in your ./dist/css and ./dist/js folders respectively.


Caramel has been designed for any browser that supports CSS3. Caramel has been tested, and is recommended for use on:

Chrome Firefox Safari Opera Edge IE
21+ 28+ 7+ 12.1+ 20+ 10, 11