Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ibm/css-gridish
Automatically build your grid design’s CSS Grid code, CSS Flexbox fallback code, Sketch artboards, and Chrome extension.
https://github.com/ibm/css-gridish
design
Last synced: about 2 months ago
JSON representation
Automatically build your grid design’s CSS Grid code, CSS Flexbox fallback code, Sketch artboards, and Chrome extension.
- Host: GitHub
- URL: https://github.com/ibm/css-gridish
- Owner: IBM
- License: other
- Archived: true
- Created: 2018-01-23T01:39:08.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-18T17:32:22.000Z (over 5 years ago)
- Last Synced: 2024-09-25T21:43:34.092Z (about 2 months ago)
- Topics: design
- Language: CSS
- Homepage: https://ibm.github.io/css-gridish/
- Size: 609 KB
- Stars: 2,249
- Watchers: 66
- Forks: 113
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# CSS Gridish
CSS Gridish takes design specs of your product’s grid and builds out several resources for your team to use:
* Sketch file with artboards and grid/layout settings for designers
* CSS/SCSS code using CSS Grid with a CSS Flexbox fallback for developers
* [Google Chrome extension](https://chrome.google.com/webstore/detail/css-gridish/ebhcneoilkamaddhlphlehojpcooobgc) for anyone to check a webpage’s alignment
**This tool is not a grid system with a grid already designed for you.** Instead, CSS Gridish builds all of the resources for the grid your team designed.
We hope it helps teams adapt CSS Grid sooner and enables more complex layouts. To show how versatile the tool is, we have examples of grids from [Bootstrap,](https://ibm.github.io/css-gridish/examples/bootstrap/index.html) [Carbon Design System,](https://ibm.github.io/css-gridish/examples/carbon/index.html) and [Material Design.](https://ibm.github.io/css-gridish/examples/material/index.html)
The truth is that many enterprise projects can’t afford to drop support for browsers that do not [support CSS Grid Layout](https://developer.mozilla.org/en-US/docs/Web/CSS/grid#Browser_compatibility) yet. This tool takes your grid’s design specs and builds a slim CSS Grid Layout implementation and a fallback to [CSS Flexbox support.](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout#Browser_compatibility)
## Build your grid code
Requires [Node v8.2.0](https://nodejs.org/en/) or higher, which includes npm and npx.
1. Create a file called `css-gridish.json` in your project root. See the [config documentation](#config-file) or an [example config](./examples/material/css-gridish.json) for help.
2. Determine how you want your grid built:
* If you want to build once, run command `npx css-gridish`.
* If you want to add the grid building to your project’s build process:
1. Run command `npm install css-gridish`.
2. Add `scripts: {build: "css-gridish"}` in your `package.json`.
3. Run command `npm run build`.
Your CSS and `README.md` with class documentation will be built into `./css-gridish/`.
### Config file
The config file is where all of your design system specs live. See this [example](./examples/carbon/css-gridish.json) for help. Edit your `css-gridish.json` to have all generated grid content match your design system:
```
{
"prefix": "gridish", // Custom prefix for all classes and filenames
"breakpoints": {
// Class name for a breakpoint
"sm": {
"breakpoint": 20, // Min-width for media query (number in rem)
"columns": 4, // Quantity of columns (number)
"gutter": "2rem", // Space between columns (rem string, px string, vw string or 0)
"margin": "3vw" // Horizontal margin of grid container (rem string, px string, vw string or 0)
},
...
"max": {
"breakpoint": 100,
"columns": 12,
"gutter": "4rem",
"margin": "5vw"
}
},
"extraArtboards": {
"xlg": 100 // Additional breakpoint for the Sketch file (number in rem)
},
"rem": 16, // Base rem unit for all measurements (number in px)
"rowHeight": 0.5, // Height of a fixed row (number in rem)
"rows": 30, // Quantity of row variables (number)
"paths": {
"route": "css-gridish", // Route that files save in from project root (optional, use `""` for project root, `"css-gridish"` is default)
"intro": "intro.md" // Path to any markdown you want inserted at the top of your README.md documentation (optional)
}
}
```
**Tip:** For the best results in Sketch, we recommend you make your grid breakpoints, margin, and gutter divisible by the row height.
**Required:** Even if your design specs do not change between breakpoints, you need to list the max-width breakpoint in the `breakpoints` object.
The first breakpoint min-width media query is not used to save kilobytes, but we recommend stating it anyways for future artboard-making tools.
## Legacy support
If you are supporting browsers that lack [CSS Grid Layout support](https://developer.mozilla.org/en-US/docs/Web/CSS/grid#Browser_compatibility), you can use `css-gridish/yourPrefix-legacy.min.css` and the legacy classes detailed in the `README.md`. With the legacy file and classes, the browsers that do not support the final CSS Grid Legacy spec will fallback to a CSS Flexbox alternative. The CSS Flexbox alternative supports embedded subgrids that still reflect the overall grid system’s column structure.
### User-defined breakpoints
One of the best parts about CSS Grid Layout is that your users can rearrange the layout at any width in their own media query. Your grid will also support rearranging layout at custom breakpoints for the legacy implementation when the user compiles their own Sass. Just have them define the following map of rem widths before they import in your Sass file:
```scss
$extraBreakpoints: (
xsm: 10,
whatever: 78,
superxlarge: 1000,
...
);
@import './css-gridish/scss/yourPrefix-legacy.scss;
```
### Transitioning from Legacy
Once your experience can drop support for browsers like IE 11 and Edge <15, you can simply remove all legacy classes and switch over to the non-legacy files. This is a great progressive-enhancement for your performance when it happens.
## Future Updates
* [ ] Once Edge and Safari gain `display: subgrid` support, we can remove our dependence on `vw` units.
* [ ] Once a solution in the CSS Grid spec is given for [one item to ignore](https://github.com/w3c/csswg-drafts/issues/2117) `grid-gap`, we can utilize `grid-gap` by default instead of opting in to padding classes.
## FAQs
### Why does none of the CSS Grid code use `grid-gap` for gutters?
A lot of times, you will want an item to break out of the gutters for background color, to extend media, or for another reason. Until the CSS Grid spec has a way to ignore that gutter, we use the padding classes (`.yourGrid-padding`) to opt-in to respecting the gutter. The padding classes are always half the size of a gutter for alignment.
### Why are columns using vw units and sometimes the calc function?
Until Edge and Safari support
[`display: subgrid`](https://developer.mozilla.org/en-US/docs/Web/CSS/display#Browser_compatibility),
it will be difficult for you to write semantic HTML with CSS Grid Layout. We are
able to take advantage of vw units and the calc function so you can embed your
`.yourPrefix-grid` class inside of itself as much that is needed for you.
### Why are there no row classes for the legacy implementation?
Thanks to flexbox’s wrapping functionality, nodes that specify rows are not necessary. Only create a node for a row if it has semantic or accessibility significance. You can keep embedding `.yourPrefix-grid` as necessary to accomplish this.
### What happens in the legacy implementation if I specify the column width for one breakpoint, but not the next larger breakpoint?
To maintain a mobile-first opinion, column widths will scale to the next breakpoint if not specified. This means that a `.yourPrefix__col--sm--3` (with 6 total columns) would automatically grow into a `.yourPrefix__col--md--6` (with 12 total columns) if no `md` class was declared to maintain half of the screen size.