^{Get started} Quick start

There are 4 ways to get started:

A. Install manually #

Download CSS archive and link css/blades.css in the <head> of your website.

<link rel="stylesheet" href="css/blades.css" />

B. Usage from CDN #

<link rel="stylesheet" href="
  https://cdn.jsdelivr.net/npm/@anyblades/blades@3/css/blades.min.css
"/>

Live example: /pallets/website/blob/main/src/pallets/templates/layout.html

Full list of CSS files available on CDN: /npm/@anyblades/blades@3/css

C. Install with NPM #

npm install @anyblades/blades

Then, @import Blades into your CSS file:

@import "@anyblades/blades";

Alternatively, import only the parts you need, e.g. per page or per component. They come wrapped in @layer blades, so your unlayered styles win over them:

@import "@anyblades/blades/variables";
@import "@anyblades/blades/layout/document";
@import "@anyblades/blades/content/typography";
@import "@anyblades/blades/components/card";
@import "@anyblades/blades/components/modal";

• variables and layout/document are the minimum; keep the same order as src/pico/_index.css.
• Some parts build on others, e.g. components/modal expects components/card, and components/group and components/dropdown expect forms/basics and content/button.
• See Layered modules for the available parts, and for importing them from JavaScript in bundlers and component frameworks (SvelteKit, Next.js, Nuxt, Astro, …).
• See package.json for a list of all exported parts.

D. Official starters #

• /buildawesome-one/starter
• /buildawesome-one/examples
• /getgrav/grav-theme-quark2
• /getgrav/grav-plugin-devtools

Starter HTML template #

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="color-scheme" content="light dark" />
    <link rel="stylesheet" href="css/blades.css" />
    <title>Hello world!</title>
  </head>
  <body>
    <main class="container">
      <h1>Hello world!</h1>
    </main>
  </body>
</html>

Using Nunjucks, Twig or Liquid? Check out the built-in Base HTML templates for each engine, ready to be used in your project.