Docs / Getting Started

Getting Started

Add VeloraCSS to your project and start building with vel- utility classes — the framework that thinks in context.

Via GitHub (direct link)

Quickest way to start: link velora.min.css from the GitHub release. Drop this in your <head>:

index.html
<link rel="stylesheet" href="https://raw.githubusercontent.com/VeloraX/veloracss/main/dist/velora.min.css">

Or download velora.css / velora.min.css from the dist/ folder on GitHub.

Build from source

Clone and build locally for full customization:

Windows PowerShell
git clone https://github.com/VeloraX/veloracss.git
cd veloracss
npm install
npm run build
# → dist/velora.css
# → dist/velora.min.css

npm COMING SOON

npm packaging is on the roadmap. Once published:

Windows PowerShell
# Not yet available
npm install veloracss

Your first component

Once VeloraCSS is loaded, compose components using vel- utility classes:

index.html
<div class="vel-card vel-p-6 vel-max-w-sm">
  <h2 class="vel-text-xl vel-font-semibold vel-mb-2">Hello, VeloraCSS</h2>
  <p class="vel-text-sm vel-text-neutral-500 vel-mb-4">
    Utility-first styling, ready out of the box.
  </p>
  <button class="vel-btn vel-btn-primary">Get started</button>
</div>

Hello, VeloraCSS

Utility-first styling, ready out of the box.

The DNA Color System

VeloraCSS introduces Color Genetics — one hue number drives your entire color system via oklch(). Override the DNA hue and everything recolors automatically:

your-theme.css
:root {
  /* Change this one number — everything updates */
  --vel-dna-hue: 145;  /* was 258 (violet), now 145 (forest green) */
}

/* All other tokens derive from it automatically:
   --vel-color-primary: oklch(65% 0.21 var(--vel-dna-hue))
   --vel-surface-0:     oklch(7%  0.02 var(--vel-dna-hue))
   --vel-text-1:        oklch(92% 0.015 var(--vel-dna-hue)) */

Design tokens

The full design system is exposed as --vel-* CSS custom properties. Override any token at :root to customize:

--vel-primary-500Brand violet#7c5cfc
--vel-success-500Success emerald#0ecb81
--vel-danger-500Danger rose#f0416c
--vel-warning-500Warning amber#ff9d00
--vel-space-41rem spacing1rem
--vel-radius-lgLarge radius0.5rem
your-theme.css
:root {
  --vel-primary-500: #7c5cfc;       /* override brand color */
  --vel-radius-lg:   0.75rem;       /* override radius */
  --vel-font-sans:   'Inter', system-ui, sans-serif;
}

Next steps

Explore the full reference in the sidebar. Start with utilities, then dive into the components.

Utility ClassesButtonsDisplayColors

CDN

Use VeloraCSS without npm via jsDelivr. No build step required — drop the link tag in your <head> and start using vel- classes immediately.

Latest (auto-updates to newest 1.x):

index.html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/veloracss@1/dist/velora.min.css">

Pinned to v1.0.0 (no surprise updates):

index.html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/veloracss@1.0.0/dist/velora.min.css">
Add this to your HTML <head>
No build step, no npm required. Drop the link tag in and start using vel- classes immediately.
Latest<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/veloracss@1/dist/velora.min.css">
Pinned<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/veloracss@1.0.0/dist/velora.min.css">
Edit on GitHub →