# @coffeekraken/gridle

> Gridle grid system

Latest version **0.0.6** (published 2019-12-19) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @coffeekraken/gridle
pnpm add @coffeekraken/gridle
yarn add @coffeekraken/gridle
bun add @coffeekraken/gridle
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.0.6 |
| Published | 2019-12-19 |
| First published | 2019-11-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 178.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Coffeekraken |
| Maintainers | olivierbossel |
| Keywords | coffee, kraken, coffeekraken, gridle, grid, system, sass, responsive |

## Links

- npm: https://www.npmjs.com/package/@coffeekraken/gridle
- Repository: https://github.com/coffeekraken/coffeekraken/tree/master/layout/gridle
- Homepage: https://coffeekraken.io
- npm.io page: https://npm.io/package/@coffeekraken/gridle

## Alternatives

- [@lexical/table](https://npm.io/package/@lexical/table.md) — 3.0M weekly downloads
- [mantine-datatable](https://npm.io/package/mantine-datatable.md) — 98.2K weekly downloads
- [react-native-collapsible-tab-view](https://npm.io/package/react-native-collapsible-tab-view.md) — 70.6K weekly downloads
- [@handsontable/vue3](https://npm.io/package/@handsontable/vue3.md) — 16.1K weekly downloads
- [vuewordcloud](https://npm.io/package/vuewordcloud.md) — 7.2K weekly downloads

## Recent versions

- 0.0.6 (latest) — 2019-12-19
- 0.0.5 — 2019-12-04
- 0.0.4 — 2019-11-13
- 0.0.3 — 2019-11-13

## README

![Gridle](.resources/gridle-head.png)

# Gridle

Gridle is a simple but powerful and convenient grid that make use of the CSS grid model. It has been rewritten from the ground up to be more simple to use without loosing his principle goals that are the flexibility and his responsive capabilities.

## Table of content

1. [Install](#install)
2. [Get started](doc/00.get-started.md)
3. [Settings](doc/02.settings.md)
4. [States](doc/02.states.md)
5. [Classes](doc/03.classes.md)
6. [Functions](doc/04.functions.md)
7. [Mixins](doc/05.mixins.md)

<a id="readme-install"></a>
## Install

Gridle is available through NPM. To install it, just launch this command line:

```
npm i @coffeekraken/gridle --save
```

## Quick start

Importing gridle

```scss
@use 'node_modules/@coffeekraken/gridle/index' as gridle;
```

Configure your grid :

```scss
@include gridle.setup((
	columns: 12,
	column-width: 60, // unitless value
	width: 1200, // unitless value
	container-width: 85vw, // absolute value
	container-max-width: 1440px
));
```

Register states (media queries) (optional) :

```scss
@include gridle.register-state(tablet, (
	min-width : 640px
));
@include gridle.register-state(desktop, (
	min-width : 992px
));

// even with full custom queries :
@include gridle.register-state (landscape, (
	query : "(orientation : landscape)"
));
```

Generate all classes :

```scss
@include gridle.classes();
```

Use your grid in html :

```html
<div class="gr">
	<div class="col col--12 hide@tablet">
		Header
	</div>
	<div class="col col--12 col--4@tablet">
		Content
	</div>
	<div class="col col--12 col--4@tablet">
		Sidebar
	</div>
</div>
```

Customize your content look and feel with Gridle mixins

```scss
#sidebar {
	background : red;

	@include gridle.state(tablet) {
		background : green;
	}
}
```

## Generate custom classes

Gridle allows you to generate custom classes that will be available for each of your states. Here's an exemple

```scss
@include gridle.custom-class('center') {
	text-align : center;
}
```

This will produce the classes : center, center@tablet, center@desktop and center@landscape automatically

# Coffeekraken

We are a young collective of front-end creative developers with one goal in mind. Build tools to make every team working day life better. This is our first and only concern. All our tools are build around that purpose.
All what we provide are some cool tools that you can use the way you want. These tools features cover a large scope of the front-end workflow (styleguide generation, colors/fonts management, etc...). You can use only the parts that you need and let the rest aside...

[![Coffeekraken](.resources/coffeekraken-logo.jpg)](https://coffeekraken.io)

---
_Source: https://npm.io/package/@coffeekraken/gridle · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
