Borealis — CSS framework
Docs
Info
@cryb/borealis
is the CSS framework for all Cryb web apps.
Borealis is built to unify UI design across our web app, admin panel, landing page and any future web apps we build. It is not intended to be used in non-Cryb applications, but feel free to do so.
It uses Sass as its main preprocessor.
Features
- Mobile support
- Dark mode support
Status
@cryb/borealis
has been actively developed since December 2019.
Installation
This library is available on the NPM registry. To install, run:
npm i @cryb/borealis --save
If you're using Yarn, run:
yarn add @cryb/borealis
CDN
@cryb/borealis
is also available through unpkg and jsdelivr.
Note: you only need to include one CSS file. Below we include both minified and unminified CDN links—we recommend that you use the minified version
unpkg
# Minified
https://unpkg.com/@cryb/borealis@latest/css/borealis.min.css
# Uminified
https://unpkg.com/@cryb/borealis@latest/css/borealis.css
jsdelivr
# Minified
https://cdn.jsdelivr.net/npm/@cryb/borealis@0.0.3/css/borealis.min.css
# Unminified
https://cdn.jsdelivr.net/npm/@cryb/borealis@0.0.3/css/borealis.css
Usage
Compiled CSS can be found under @cryb/borealis/dist/
as borealis.css
and borealis.min.css
.
We recommend you use borealis.min.css
in production environments.
HTML
Simply link Borealis as you would any other CSS file:
<head>
<link rel="stylesheet" href="css/borealis.min.css">
</head>
Borealis is also offered through a CDN. While we recommend you download Borealis locally, you can use either unpkg or jsdelivr.
unpkg
<link rel="stylesheet" href="https://unpkg.com/@cryb/borealis@latest/css/borealis.min.css" />
<link rel="stylesheet" href="https://unpkg.com/@cryb/borealis@latest/css/borealis.min.css" />
jsdelivr
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@cryb/borealis@0.0.3/css/borealis.min.css" />
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@cryb/borealis@0.0.3/css/borealis.css" />
Nuxt.js
After installation, Borealis can be easily integrated into a Nuxt.js project through nuxt.config.js
. See the example below:
export default {
css: [
'@cryb/borealis'
]
}
Codebase
The codebase for @cryb/borealis
is written in Sass.
Folder Structure
cryb/borealis/
├──┐ src # Uncompiled Sass
│ ├── components # Buttons, boxes, etc
│ ├── pages # Styles for pages
│ └── utils # Static variables
├─── dist # Compiled CSS
└──┐ examples # Pages to test compiled CSS
└── assets # Assets for example pages
First time setup
First, clone the @cryb/borealis
repository locally:
git clone https://github.com/crybapp/borealis.git
Installation
You also need to install the required dependencies by running yarn
.
Compiling CSS locally
To run @cryb/borealis
in development mode, run yarn dev
. This mode will watch for changes on .sass
files under dist/
and then compile accordingly.
Once you have finished your changes, run yarn build
to fully compile to dist/
. You should do this before committing.
Questions / Issues
If you have an issues with @cryb/borealis
, please either open a GitHub issue, contact a maintainer or join the Cryb Discord Server and ask in #tech-support