Veylo Docs

HomeDocsGetting started

Getting started

Veylo is a stylesheet. Add it to a page, wrap your content in .veylo, and plain HTML elements already look right. A small optional script adds behaviour such as the theme switcher, sorting and keyboard selection.

1. Add the files

<link rel="stylesheet" href="https://veylo.ar0.eu/cdn/css">
<script src="https://veylo.ar0.eu/cdn/js" defer></script>

Both URLs are served with CORS enabled. You can also download the files and host them yourself: veylo.css and veylo.js have no dependencies and need no build step.

2. Wrap your content

<div class="veylo" data-theme="graphite">
  <div class="veylo-win">
    <h1 class="veylo-title"><span>Hello</span></h1>
    <div class="veylo-body">
      <p>Plain elements are styled for you.</p>
      <button class="primary">Click me</button>
    </div>
  </div>
</div>

Everything is scoped to .veylo, so Veylo never touches the rest of your page. You can put it around the whole body or around one section.

3. Rules of thumb

KindLooks likeExamples
Plain elementsno class neededbutton, input, select, table, h2, details
Componentsveylo-nameveylo-win, veylo-card, veylo-tabbar
Modifiersbare wordsprimary, sm, on, dis, sunk
Utilitiesshort bare classesflex, grid cols-3, gap2, mt2, cluster, dim, b, mono
ColourCSS variables--face, --field, --acc, --text

Design principles

  • No images. Bevels are box-shadows, icons are clip-paths and inline SVG, cursors are SVG data URIs.
  • No rounding. Only true circles (avatars, radio buttons) are round.
  • Works without JavaScript. The script only adds behaviour; the look is pure CSS.
  • Keyboard first. Lists, tables, trees, menus and tabs take arrows, Shift and Ctrl natively. See Keyboard and mouse.

Next: Themes and tokens, or browse everything running in the showcase.