Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@chialab/cells

Package Overview
Dependencies
Maintainers
0
Versions
27
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@chialab/cells

A strongly opinionated modular utility-first CSS library.

  • 1.6.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
170
increased by102.38%
Maintainers
0
Weekly downloads
 
Created
Source

Cells

A strongly opinionated modular utility-first CSS library.

Why

Cells looks like just any another utility-first CSS library like bootstrap, tailwind and unocss, but it has a slightly different scope. The library is designed to work as a configurable primer for themable components library and frontend skeletons.

Since it does not try to cover the entire styling experience of a project, it does not require build-time optimizations. You can import base custom properties and classes using plain CSS imports and load opinionated rules from the provided presets.

Please note that Cells does not aim to compete in the CSS frameworks market. It will evolve in the only interest of our development teams, but we are happy to share and discuss design choices with other developers.

Cells is distribuited as plain CSS files. You can import the whole library using the index.css file or single modules from the lib folder. Each module is configurable using CSS custom properties.

Implemented modules:

  • Spacing defines base spacing variables
  • Colors defines base theming variables such as primary, secondary and accent colors and base text and background colors classes
  • Typography defines base variables for families, weights and size scale, as well as declinated classes for composition
  • Layout contains classes for general grid layout, as well as utility classes for flexbox specs
  • Paddings contains classes to set incremental paddings, from p-0 to p-10 and with px, py, pt, pr, pb, pl variants
  • Margins contains classes to set incremental margins, from m-0 to m-10 and with mx, my, mt, mr, mb, ml variants
  • Borders contains radius-N classes for rounded borders
  • Shadows contains both classes for inset shadows, from deep-1 to deep-4, and drop shadows from elevation-0 to elevation-10 plus elevation-12, elevation-186 and elevation-24
  • Outline customizes the global page outline for keyboard navigation
  • Scollbar contains classes to customize scrollbars

Presets:

  • Website configures the grid layout for each viewport (mobile 4 columns, tablet portrait 6 columns, tablet landscape 8 columns, desktop 12 columns)

Usage

NPM

You can install and consume Cells with npm:

npm i @chialab/cells
yarn add @chialab/cells

and import it in your stylesheet:

@import '@chialab/cells';

Correctly set --window-width variable.

Viewport units (vw, vh) do not take into account scrollbars width. To solve this problem we have introduced the --window-width variable that can be set using the following JavaScript snippet:

function updateViewportSize() {
    document.documentElement.style.setProperty('--window-width', `${document.body.clientWidth}px`);
}

updateViewportSize();
window.addEventListener('resize', updateViewportSize);

License

Cells is released under the MIT license.

FAQs

Package last updated on 28 Oct 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc