# PaperCSS

### the less formal CSS framework

Download Docs About Github

### Summary:

- Flexbox
- Typography
- Buttons
- Forms
- Lists
- Code
- Tables
- Popovers
- Colors
- Borders & shadows
- Utilities
- Images
- Alerts

## Flexbox

#### Flexgrid

The flexgrid is a grid system that supports up to 12 columns per row. Because it uses flexbox (rather than just %widths), we also get the benefit of the fun parts of flexbox like alignment in more complex ways than normal.

col-4 col
col-4 col
col-4 col
col-3 col
col-9 col
sm-6 md-8 lg-10 col
sm-6 md-4 lg-2 col
sm-5 col
col-fill col
col-fill col
Aligned
Left (default)
Aligned
Right (flex-right)
Aligned
Center (flex-center)
Aligned
to edges (flex-edges)
Aligned
to be evenly spaced (flex-spaces)
Aligned top
Aligned top
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
Aligned middle
Aligned middle
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
Aligned bottom
Aligned bottom
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
Align bottom
Align middle
Align top
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.

    <div class="row">
      <div class="col-4 col">col-4 col</div>
      <div class="col-4 col">col-4 col</div>
      <div class="col-4 col">col-4 col</div>
    </div>
    <div class="row">
      <div class="col-3 col">col-3 col</div>
      <div class="col-9 col">col-9 col</div>
    </div>
    <div class="row">
      <div class="sm-6 md-8 lg-10 col">sm-6 md-8 lg-10 col</div>
      <div class="sm-6 md-4 lg-2 col">sm-6 md-4 lg-2 col</div>
    </div>
    <div class="row">
      <div class="sm-5 col">sm-5 col</div>
      <div class="col-fill col">col-fill col</div>
      <div class="col-fill col">col-fill col</div>
    </div>
    <div class="row">
      <div class="sm-4 col">Aligned</div>
      <div class="sm-4 col">Left (default)</div>
    </div>
    <div class="row flex-right">
      <div class="sm-4 col">Aligned</div>
      <div class="sm-4 col">Right (flex-right)</div>
    </div>
    <div class="row flex-center">
      <div class="sm-4 col">Aligned</div>
      <div class="sm-4 col">Right (flex-right)</div>
    </div>
    <div class="row flex-edges">
      <div class="sm-4 col">Aligned</div>
      <div class="sm-4 col">to edges (flex-edges)</div>
    </div>
    <div class="row flex-spaces">
      <div class="sm-4 col">Aligned</div>
      <div class="sm-4 col">to be evenly spaced (flex-spaces)</div>
    </div>
    <div class="row flex-top">
      <div class="sm-6 col">Aligned top</div>
      <div class="sm-6 col">
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
      </div>
    </div>
    <div class="row flex-middle">
      <div class="sm-6 col">Aligned middle</div>
      <div class="sm-6 col">
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
      </div>
    </div>
    <div class="row flex-bottom">
      <div class="sm-6 col">Aligned bottom</div>
      <div class="sm-6 col">
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
      </div>
    </div>
    <div class="row">
      <div class="sm-3 col align-bottom">Align bottom</div>
      <div class="sm-3 col align-middle">Align middle</div>
      <div class="sm-3 col align-top">Align top</div>
      <div class="sm-3 col">
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem lectus, lobortis a nibh non, luctus luctus erat posuere. Curabitur ac turpis aliquam, malesuada elit suscipit, blandit dolor.
      </div>
    </div>

## Typography

How pretty is the text?

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean ultrices, eros non elementum accumsan, massa nulla aliquam libero, ut posuere justo nibh ac ipsum. Aliquam blandit commodo justo at laoreet. Suspendisse potenti. Duis magna neque, venenatis non libero a, tincidunt convallis diam. Donec vel fermentum ante. Quisque diam nisl, vestibulum imperdiet sapien nec, interdum fringilla lorem. Morbi sed arcu facilisis, maximus justo vel, porttitor nisl. Nam suscipit metus facilisis iaculis vestibulum.

    <h1>Heading 1</h1>
    <h2>Heading 2</h2>
    <h3>Heading 3</h3>
    <h4>Heading 4</h4>
    <h5>Heading 5</h5>
    <h6>Heading 6</h6>
    <p>Lorem ipsum dolor....</p>

## Buttons

Insprired by Imprefect Buttons

Link

    <p>Insprired by <a href="https://codepen.io/tmrDevelops/pen/VeRvKX" target="_blank">Imprefect Buttons</a></p>
    <button class="btn-large">Large</button>
    <button>Default</button>
    <button class="btn-small">Small</button>
    <a href="#" class="paper-btn">Link</a>
    <div class="row">
      <div class="col-6 col">
        <button class="btn-block">Block level</button>
      </div>
    </div>
    <button class="disabled">Disabled</button>
    <button disabled>Disabled</button>

#### Colors

      <input type="button" class="paper-btn btn-primary" value="Primary"/>
      <input type="button" class="btn-secondary" value="Secondary"/>
      <button class="btn-success">Success</button>
      <button class="btn-warning">Warning</button>
      <button class="btn-danger">Danger</button>

## Forms

Input
Block Level
Block Level
Disabled
Select
Some Radio Buttons This is the first option This is the second option
Some Check Boxes This is the first check This is the second check

    <div class="form-group">
      <label>Input</label>
      <input type="text" placeholder="Nice input">
    </div>
    <div class="row">
      <div class="col sm-4">
        <div class="form-group">
          <label>Block Level</label>
          <input class="input-block" type="text">
        </div>
      </div>
      <div class="col sm-8">
        <div class="form-group">
          <label>Block Level</label>
          <input class="input-block" type="text">
        </div>
      </div>
    </div>
    <div class="form-group">
      <label>Disabled</label>
      <input type="text" placeholder="Disabled" disabled>
    </div>
    <div class="form-group">
      <label>Select</label>
      <select>
        <option value="1">Option 1</option>
        <option value="2">Option 2</option>
        <option value="3">Option 3</option>
      <select>
    </div>
    <fieldset class="form-group">
      <legend>Some Radio Buttons</legend>
      <label for="paperRadios1" class="paper-radio">
        <input type="radio" name="paperRadios" id="paperRadios1" value="option 1"> <span>This is the first option<span>
      </label>
      <label for="paperRadios2" class="paper-radio">
        <input type="radio" name="paperRadios" id="paperRadios2" value="option 2"> <span>This is the second option<span>
      </label>
    </fieldset>
    <fieldset class="form-group">
      <legend>Some Check Boxes</legend>
      <label for="paperChecks1" class="paper-check">
        <input type="checkbox" name="paperChecks" id="paperChecks1" value="option 1"> <span>This is the first check</span>
      </label>
      <label for="paperChecks2" class="paper-check">
        <input type="checkbox" name="paperChecks" id="paperChecks2" value="option 2"> <span>This is the second check</span>
      </label>
    </fieldset>

## Lists

#### Ordered Lists

1. Do this
2. Then this
3. Finally this
4. Then we'll go one deeper

1. Dillon
2. Francis

1. What if we went...
2. One more deeper?

1. DJ
2. Hanzel

1. Five levels should be enough
2. Right?

5. But don't forget this

#### Unordered Lists

- Let's try this
- Let's try this again

- And now we are nested
- Pretty cool?

- The list items are just text
- From this font

- We'll keep going
- Until we hit

- LEVEL 5

- And now we're are the top!

    <ol>
      <li>Do this</li>
      <li>Then this</li>
      <li>Finally this</li>
      <li>Then we'll go one deeper</li>
      <ol>
          <li>Dillon</li>
          <li>Francis</li>
          <ol>
            <li>What if we went...</li>
            <li>One more deeper?</li>
            <ol>
              <li>DJ</li>
              <li>Hanzel</li>
              <ol>
                <li>Five levels should be enough</li>
                <li>Right?</li>
              </ol>
            </ol>
          </ol>
      </ol>
      <li>But don't forget this</li>
    </ol>

    <!-- Replace ol with ul for unordered lists. Go up to 5 levels deep! -->

## Code

Let's make some pretty `<code>`

Print files backwards using `tac`

To stop a process, hit `ctrl + c`

    function add(x, y) {
      return x + y;
    }

    <p>Let's make some pretty <code>&lt;code&gt;</code></p>
    <p>Print files backwards using <kbd>tac</kbd></p>
    <p>To stop a process, hit <kbd>ctrl + c</kbd></p>
    <pre>
      function add(x, y) {
        return x + y;
      }
    </pre>

## Tables

#### Regular

# | Name | Position | Location
--- | --- | --- | ---
1 | Bob Dylan | Musician | California, USA
2 | Eric Clapton | Musician | Ohio, USA
3 | Daniel Kahneman | Psychologist | California, USA

#### Hover

# | Name | Position | Location
--- | --- | --- | ---
1 | Bob Dylan | Musician | California, USA
2 | Eric Clapton | Musician | Ohio, USA
3 | Daniel Kahneman | Psychologist | California, USA

#### Alternating

# | Name | Position | Location
--- | --- | --- | ---
1 | Bob Dylan | Musician | California, USA
2 | Eric Clapton | Musician | Ohio, USA
3 | Daniel Kahneman | Psychologist | California, USA

    <table>
      <thead>
        <tr>
          <th>#</th>
          <th>Name</th>
          <th>Position</th>
          <th>Location</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>1</td>
          <td>Bob Dylan</td>
          <td>Musician</td>
          <td>California, USA</td>
        </tr>
        <tr>
          <td>2</td>
          <td>Eric Clapton</td>
          <td>Musician</td>
          <td>Ohio, USA</td>
        </tr>
        <tr>
          <td>3</td>
          <td>Daniel Kahneman</td>
          <td>Psychologist</td>
          <td>California, USA</td>
        </tr>
      </tbody>
    </table>

    <!-- Add table-hover or table-alternating to change the style of the table -->
    <table class="table-hover">
    <table class="table-alternating">

## Popovers

#### Basic usage

You can add popovers, also called tooltips, on your elements. popover attribute is the popover text content, popover-position attribute can be: top, left, right, bottom.

Popover left position

Popover top position

Popover bottom position

Popover right position

    <p popover="Popover on left" popover-position="left">Popover left position</p>
    <p popover="Popover on top" popover-position="top">Popover top position</p>
    <p popover="Popover on bottom" popover-position="bottom">Popover bottom position</p>
    <p popover="Popover on right" popover-position="right">Popover right position</p>

But you can also popover on pretty much any element you want, it can be on a button, on a table cell, ...

    <button popover="Popover on top" popover-position="top">Popover on top and on a button!</button>

## Cards

#### Full card example

It is possible to not put all the sub-classes like card-title, card-subtitle, card-text, ... But instead the framework will recognize the element properly if it's a h4, h5, p, ... And you need to put all this content on a div with card class.

#### My awesome Paper card!

##### Nice looking subtitle.

Notice that the card width in this example have been set to 20rem, otherwise it will try to fill the current container/row where the card is.

    <div class="card" style="width: 20rem;">
      <img src="https://picsum.photos/768" alt="Card example image">

      <div class="card-body">
        <h4 class="card-title">My awesome Paper card!</h4>
        <h5 class="card-subtitle">Nice looking subtitle.</h5>
        <p class="card-text">Notice that the card width in this example have been set to 20rem, otherwise it will try to fill the current container/row where the card is.</p>
        <button>Let me go here!</button>
      </div>
    </div>

#### Card title, text, links

#### My awesome Paper card!

##### Nice looking subtitle.

This is another example of a card without image. Cards are also meant to be used without images, but with text/links/buttons.

First link Second link

    <div class="card" style="width: 20rem;">
      <div class="card-body">
        <h4 class="card-title">My awesome Paper card!</h4>
        <h5 class="card-subtitle">Nice looking subtitle.</h5>
        <p class="card-text">This is another example of a card without image. Cards are also meant to be used without images, but with text/links/buttons.</p>
        <a class="card-link" href="#">First link</a>
        <a class="card-link" href="#">Second link</a>
      </div>
    </div>

#### Image on top or bottom

#### My awesome Paper card!

##### Nice looking subtitle.

You can also place image on the bottom of the card.

    <div class="card" style="width: 20rem;">
      <div class="card-body">
        <h4 class="card-title">My awesome Paper card!</h4>
        <h5 class="card-subtitle">Nice looking subtitle.</h5>
        <p class="card-text">You can also place image on the bottom of the card.</p>
        <button>Let me go here!</button>
      </div>
      <img class="image-bottom" src="http://via.placeholder.com/550x250" alt="Card example image">
    </div>

#### Header and footer

Header

#### My awesome Paper card!

##### Nice looking subtitle.

You can also place image on the bottom of the card.

    <div class="card" style="width: 20rem;">
      <div class="card-header">Header</div>
        <div class="card-body">
          <h4 class="card-title">My awesome Paper card!</h4>
          <h5 class="card-subtitle">Nice looking subtitle.</h5>
          <p class="card-text">You can also place image on the bottom of the card.</p>
          <button>Let me go here!</button>
        </div>
      <div class="card-footer">Footer</div>
    </div>

## Badges

#### Default

You can customize badges colors with secondary, success, warning, danger classes.

# Example h1 heading 123

## Example h2 heading 123

### Example h3 heading 123

#### Example h4 heading 123

##### Example h5 heading 123

###### Example h6 heading 123

    <h1>Example h1 heading <span class="badge">123</span></h1>
    <h2>Example h2 heading <span class="badge secondary">123</span></h2>
    <h3>Example h3 heading <span class="badge success">123</span></h3>
    <h4>Example h4 heading <span class="badge warning">123</span></h4>
    <h5>Example h5 heading <span class="badge danger">123</span></h5>
    <h6>Example h6 heading <span class="badge">123</span></h6>

## Colors

#### Text

Text primary

Text secondary

Text success

Text warning

Text danger

Text muted

    <p class="text-primary">Text primary</p>
    <p class="text-secondary">Text secondary</p>
    <p class="text-success">Text success</p>
    <p class="text-warning">Text warning</p>
    <p class="text-danger">Text danger</p>
    <p class="text-muted">Text muted</p>

#### Backgrounds

Background primary
Background secondary
Background success
Background warning
Background danger

    <div class="row flex-center">
      <div class="sm-2 col background-primary">Background primary</div>
      <div class="sm-2 col background-secondary">Background secondary</div>
      <div class="sm-2 col background-success">Background success</div>
      <div class="sm-2 col background-warning">Background warning</div>
      <div class="sm-2 col background-danger">Background danger</div>
    </div>

## Borders & Shadows

#### Borders

Default Border
Border-2
Border-3
Border-4
Border-5
Border-6

    <div class="row flex-spaces">
      <div class="sm-3 col border border-primary">Default Border</div>
      <div class="sm-3 col border border-2 border-primary">Border-2</div>
      <div class="sm-3 col border border-3 border-primary">Border-3</div>
    </div>
    <div class="row flex-spaces">
      <div class="sm-3 col border border-4 border-primary">Border-4</div>
      <div class="sm-3 col border border-5 border-primary">Border-5</div>
      <div class="sm-3 col border border-6 border-primary">Border-6</div>
    </div>

#### Border Colors

Border primary
Border secondary
Border success
Border warning
Border danger
Border white

    <div class="row child-borders">
      <div class="sm-2 col border border-primary">Border primary</div>
      <div class="sm-2 col border border-secondary">Border secondary</div>
      <div class="sm-2 col border border-success">Border success</div>
      <div class="sm-2 col border border-warning">Border warning</div>
      <div class="sm-2 col border border-danger">Border danger</div>
      <div class="sm-2 col border background-primary border-white">Border white</div>
    </div>
    <div class="row child-borders">
      <div class="sm-2 col border border-primary">Border primary</div>
      <div class="sm-2 col border border-secondary">Border secondary</div>
      <div class="sm-2 col border border-success">Border success</div>
      <div class="sm-2 col border border-warning">Border warning</div>
      <div class="sm-2 col border border-danger">Border danger</div>
      <div class="sm-2 col border background-primary border-white">Border white</div>
    </div>

#### Child Borders

Use this if you want all children to have a border. This will alternate through the different border styles defined above instead of having to add the border class for each element.

1
2
3
4
5
6

    <div class="row flex-center child-borders">
      <div class="sm-2 col">1</div>
      <div class="sm-2 col">2</div>
      <div class="sm-2 col">3</div>
      <div class="sm-2 col">4</div>
      <div class="sm-2 col">5</div>
      <div class="sm-2 col">6</div>
    </div>

#### Border Styles

Dashed
Dotted
Dashed Thick
Dotted Thick

    <div class="row flex-spaces child-borders">
      <div class="sm-3 col border-dashed">Dashed</div>
      <div class="sm-3 col border-dotted">Dotted</div>
      <div class="sm-3 col border-dashed border-thick">Dashed Thick</div>
      <div class="sm-3 col border-dotted border-thick">Dotted Thick</div>
    </div>

#### Shadows

Large
Default
Small
Hover

    <div class="row flex-spaces child-borders">
      <div class="sm-3 col shadow shadow-large">Large</div>
      <div class="sm-3 col shadow">Default</div>
      <div class="sm-3 col shadow shadow-small">Small</div>
      <div class="sm-3 col shadow shadow-hover">Hover</div>
    </div>

#### Child Shadows

Use this if you want all children to have a shadow.

Shadow
Shadow
Shadow

    <div class="row flex-spaces child-borders child-shadows">
      <div class="sm-3 col">Shadow</div>
      <div class="sm-3 col">Shadow</div>
      <div class="sm-3 col">Shadow</div>
    </div>

#### Child Shadows Hover

Use this if you want all children to have a shadow... that changes on hover

Shadow
Shadow
Shadow

    <div class="row flex-spaces child-borders child-shadows-hover">
      <div class="sm-3 col">Shadow</div>
      <div class="sm-3 col">Shadow</div>
      <div class="sm-3 col">Shadow</div>
    </div>

## Utilities

#### Margin

Margin
Margin-large
Margin-top-small

    <div class="row flex-spaces child-borders">
      <div class="sm-3 col margin">Margin</div>
      <div class="sm-3 col margin-large">Margin-large</div>
      <div class="sm-3 col margin-top-small">Margin-top-small</div>
    </div>

#### Padding

Padding-small
Padding-none
Padding-left-large

    <div class="row flex-spaces child-borders">
      <div class="sm-3 col padding-small">Padding-small</div>
      <div class="sm-3 col padding-none">Padding-none</div>
      <div class="sm-3 col padding-left-large">Padding-left-large</div>
    </div>

## Images

#### Responsive

Images by default are responsive

    <img src="https://unsplash.it/900" alt="Random Unsplash">

#### Float

You can also float responsive images to fit neatly with your text

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur non elit sed lorem vulputate consectetur sed vel orci. Nunc orci metus, hendrerit viverra diam a, viverra efficitur nisi. Suspendisse ante sapien, porta vitae augue et, pulvinar posuere nibh. Suspendisse id commodo sem, vestibulum malesuada erat. Duis luctus est sit amet nisl maximus porta. Curabitur tempor nisi tincidunt ultricies rutrum. Nam finibus turpis ut nibh dignissim, in tincidunt mauris suscipit. Curabitur sollicitudin mi quis orci semper, nec egestas nibh mollis. Aenean pellentesque lectus rutrum, ultrices felis malesuada, finibus purus. Morbi eleifend pellentesque justo, quis vestibulum mi. Donec porta ipsum tellus, ac scelerisque lectus pellentesque eget. Etiam quis rutrum dui. Nulla facilisi. Donec imperdiet mattis mi nec fringilla. Donec mollis augue sed viverra placerat. Donec varius, sem sed porttitor euismod, est nunc varius tellus, eget molestie urna arcu ac turpis. Phasellus id sem elit. Vivamus pellentesque mauris vel ex laoreet varius. Vivamus non tempor libero. Nam consectetur nisi erat, ac varius elit porttitor quis. Morbi ullamcorper, tortor in sagittis tempus, justo ipsum pretium urna, ut bibendum nisl orci et eros. Quisque ut ipsum neque. Integer sapien dolor, vestibulum id maximus ac, pharetra eu augue. Aenean mauris tellus, facilisis sed quam non, tincidunt rutrum risus. Fusce quam urna, commodo vitae nunc condimentum, efficitur commodo libero. Sed dignissim odio enim, ac pharetra dui laoreet id. Suspendisse nec accumsan erat. Integer sit amet leo arcu. Proin sagittis blandit tempor. Vivamus at egestas lectus. Mauris eros tellus, egestas ac neque eget, lacinia sagittis ante. Phasellus faucibus suscipit erat, eget malesuada neque congue non.

    <p>
      <img src="https://unsplash.it/200" class="float-left">
      Lorem ipsum dolor.......
      <img src="https://unsplash.it/100" class="float-right">
      Aenean mauris tellus......
    </p>

#### No Responsive & No Borders

If you don't like the default, you can just add the class `no-responsive` to prevent the image from being responsive. You can also remove the default border with `no-border`.

    <img src="https://unsplash.it/300" class="no-responsive no-border">

## Alerts

Alert-primary
Alert-secondary
Alert-success
Alert-warning
Alert-danger

      <div class="row flex-spaces">
        <div class="alert alert-primary">Alert-primary</div>
        <div class="alert alert-secondary">Alert-secondary</div>
        <div class="alert alert-success">Alert-success</div>
        <div class="alert alert-warning">Alert-warning</div>
        <div class="alert alert-danger">Alert-danger</div>
      </div>

## Download

Download the latest version (1.1.0) using either of the links below. Or download an older release via Github.

CSS File Minified CSS File Github Releases

If you'd rather customize things, you can build the CSS yourself via the git repo

1. `git clone [repo url]`
2. `npm install`
3. `npm run build`
4. Grab the CSS out of the /dist folder created

You can also go into src/colors.less before building to change around the colors of your new CSS.

## About

I got tired of mODerN STylEs and clean pages on the internet. I also wanted to learn more about Flexbox and Less. So I made PaperCSS to solve these two challenges of mine :)

The goal of PaperCSS is to be as minimal as possible when adding classes. For example, a button should just look like a paper button. There shouldn't be a need to add a class such as `paper-button`. Because of this, adding PaperCSS to a markdown generated page should instantly paper-ize it.

While I'm proud of how it's turned out so far, I think there's a lot that can still be done to make it better. Such things as refactoring, adding more utility classes and more border types (like dashed/dotted) could really polish off this framework. That's why it's open sourced and available for pull requests!

If you are new to Git or Less, this would be a great project to get your feet wet with. I'd be happy to help walk you through the pull request process. Check out the Git repo for more info!

Made with 💛 by Rhyne