Get started Quick start
Link blades.css manually or via CDN for a dependency-free setup, or use NPM for advanced usage.
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@2/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@2/css
C. Starter projects #
subtle.blades.ninja 11ty micro-starter
start.11ty.blades.ninja 7-in-1 starter (including Tailwind)
getgrav.org v2 now features Blades CSS in its default theme (Quark2)
jekyll.blades.ninja starter
D. Install with NPM #
npm install @anyblades/blades
You can use precompiled Pico+Blades CSS (same as CDN version):
<link rel="stylesheet" href="
node_modules/@anyblades/blades/css/blades.css
" />
Or import standalone Blades CSS sources (without Pico CSS):
@import "@anyblades/blades/standalone";
Live example using Tailwind: /anyblades/buildawesome-starters/blob/main/site-tailwind/styles.css
To install and import both Pico+Blades CSS sources at once:
npm install @anyblades/pico @anyblades/blades
@import "@anyblades/pico";
@import "@anyblades/blades/standalone";
This is exactly how Blades CSS is built itself: /anyblades/blades/blob/main/src/blades.css
Appendix #
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>
Standalone versions #
Most of internal Blades CSS modules are available as standalone helpers, giving you flexibility to use them with other CSS frameworks:
| Module | CDN | Import from NPM |
|---|---|---|
| Breakout container | N/A | |
| Link icon | N/A | |
| Responsive table | N/A | |
| Float labels |
npm install @anyblades/blades @import "@anyblades/blades/float-label"; |
|
| All above together | npm install @anyblades/blades @import "@anyblades/blades/standalone"; |
|
| Reset/normalizer |
npm install @anyblades/pico @import "@anyblades/pico"; |
|
| Experimental "ninja" add-ons | npm install @anyblades/blades @import "@anyblades/blades/ninja"; |
Live examples:
www.mattanger.dev (Link icon via CDN)