ArekUI
Docs

Utilities

Spacing, layout, sizing, typography, borders, effects and responsive helpers - every utility class the framework ships, grouped by family.

Two conventions run through all of them: a numeric scale where 1 = 0.25rem and 4 = 1rem, and a responsive prefix (ar-md:*, ar-lg:*). Color helpers live in the Colors guide, and each theme ships its own helper family (ar-neo-* ar-pixel-* ar-brutalist-* - listed on its theme page).

Spacing

Padding and margin on the shared rem scale. Only the listed numbers exist: 0 1 2 3 4 5 6 8 10 12 (12 = 3rem). Axes: nothing (ar-p-4), x/y (ar-px-4 ar-py-2), or one side (ar-mt-4 ar-mb-2 ar-pt-2 ar-pb-0).

Spacing
ar-p-8
ar-px-6 ar-py-2
ar-p-2

ar-mx-auto centers a block; ar-mt-4 adds top space.

ClassDescription
ar-p-0padding 0
ar-p-1padding 0.25rem
ar-p-2padding 0.5rem
ar-p-3padding 0.75rem
ar-p-4padding 1rem
ar-p-5padding 1.25rem
ar-p-6padding 1.5rem
ar-p-8padding 2rem
ar-p-10padding 2.5rem
ar-p-12padding 3rem
ar-px-1horizontal padding 0.25rem
ar-px-2horizontal padding 0.5rem
ar-px-3horizontal padding 0.75rem
ar-px-4horizontal padding 1rem
ar-px-6horizontal padding 1.5rem
ar-px-8horizontal padding 2rem
ar-py-1vertical padding 0.25rem
ar-py-2vertical padding 0.5rem
ar-py-3vertical padding 0.75rem
ar-py-4vertical padding 1rem
ar-py-6vertical padding 1.5rem
ar-py-8vertical padding 2rem
ar-py-12vertical padding 3rem
ar-pt-2top padding 0.5rem
ar-pt-10top padding 2.5rem
ar-pb-0bottom padding 0
ar-pb-2bottom padding 0.5rem
ar-m-0margin 0
ar-m-2margin 0.5rem
ar-m-4margin 1rem
ar-mt-1top margin 0.25rem
ar-mt-2top margin 0.5rem
ar-mt-3top margin 0.75rem
ar-mt-4top margin 1rem
ar-mt-6top margin 1.5rem
ar-mt-8top margin 2rem
ar-mb-2bottom margin 0.5rem
ar-mb-4bottom margin 1rem
ar-mb-8bottom margin 2rem
ar-my-1vertical margin 0.25rem
ar-my-2vertical margin 0.5rem
ar-my-4vertical margin 1rem
ar-my-10vertical margin 2.5rem
ar-mx-autohorizontal margins auto — centers a block

Layout, flex & grid

Display modes, flexbox, CSS grid and the gap scale.

Flex

flex justify-between

badge
Grid
1
2
3
ClassDescription
ar-flexdisplay: flex
ar-inline-flexdisplay: inline-flex
ar-griddisplay: grid
ar-blockdisplay: block
ar-inline-blockdisplay: inline-block
ar-hiddendisplay: none
ar-flex-colstack flex children vertically
ar-flex-rowflex children in a row
ar-flex-wraplet flex lines wrap
ar-flex-1grow to fill the line (flex: 1 1 0%)
ar-shrink-0never shrink
ar-items-startcross-axis: align to start
ar-items-centercross-axis: center
ar-items-endcross-axis: align to end
ar-justify-startmain axis: pack to start
ar-justify-centermain axis: center
ar-justify-betweenmain axis: space between
ar-justify-endmain axis: pack to end
ar-grid-cols-1grid with 1 equal column
ar-grid-cols-2grid with 2 equal columns
ar-grid-cols-3grid with 3 equal columns
ar-grid-cols-4grid with 4 equal columns
ar-grid-flow-colgrid auto-flows in columns
ar-gap-1gap 0.25rem
ar-gap-2gap 0.5rem
ar-gap-3gap 0.75rem
ar-gap-4gap 1rem
ar-gap-6gap 1.5rem
ar-gap-x-2column gap 0.5rem
ar-gap-x-4column gap 1rem
ar-gap-x-8column gap 2rem
ar-gap-y-8row gap 2rem
ar-gap-y-16row gap 4rem

Sizing

Width, height, min/max-width and overflow. Widths follow the shared --ar-s-* rem scale (n × 0.25rem) with steps 8 16 24 32 40 48 60 80 (2rem → 20rem), plus ar-w-full and fractions (ar-w-1/3 ar-w-11/12). The ar-max-w-* series (sm 24rem → 7xl 80rem) is how the docs cap line length.

Sizing
ar-w-1/2
ar-w-1/3
ar-max-w-md
ClassDescription
ar-w-8width 2rem
ar-w-16width 4rem
ar-w-24width 6rem
ar-w-32width 8rem
ar-w-40width 10rem
ar-w-48width 12rem
ar-w-60width 15rem
ar-w-80width 20rem
ar-w-fullwidth 100%
ar-w-1/3width 33.3%
ar-w-2/3width 66.7%
ar-w-1/2width 50%
ar-w-11/12width 91.7%
ar-h-8height 2rem
ar-h-48height 12rem
ar-h-fullheight 100%
ar-min-h-fullmin-height 100%
ar-min-h-screenmin-height 100vh
ar-max-w-noneno max width
ar-max-w-smmax-width 24rem
ar-max-w-mdmax-width 28rem
ar-max-w-lgmax-width 32rem
ar-max-w-xlmax-width 36rem
ar-max-w-2xlmax-width 42rem
ar-max-w-3xlmax-width 48rem
ar-max-w-4xlmax-width 56rem
ar-max-w-5xlmax-width 64rem
ar-max-w-6xlmax-width 72rem
ar-max-w-7xlmax-width 80rem
ar-aspect-video16:9 aspect ratio
ar-object-coverimages cover the box (object-fit: cover)
ar-overflow-hiddenclip overflow
ar-overflow-x-autohorizontal scrollbar when content overflows

Typography

The type scale (ar-text-xs → ar-text-9xl, plus the marketing-size ar-text-hero), weights, alignment, wrapping and a few text extras.

Type scale

ar-text-xs

ar-text-sm

ar-text-base

ar-text-lg

ar-text-2xl ar-font-bold

ar-text-center

ar-leading-tight ar-tracking-wider

ClassDescription
ar-text-xsfont-size 0.75rem
ar-text-smfont-size 0.875rem
ar-text-basefont-size 1rem
ar-text-lgfont-size 1.125rem
ar-text-xlfont-size 1.25rem
ar-text-2xlfont-size 1.5rem
ar-text-3xlfont-size 1.875rem
ar-text-4xlfont-size 2.25rem
ar-text-5xlfont-size 3rem
ar-text-6xlfont-size 3.75rem
ar-text-7xlfont-size 4.5rem
ar-text-8xlfont-size 6rem
ar-text-9xlfont-size 8rem
ar-text-heroclamp(3rem, 11vw, 6.5rem) — marketing size
ar-font-thinfont-weight 100
ar-font-normalfont-weight 400
ar-font-mediumfont-weight 500
ar-font-semiboldfont-weight 600
ar-font-boldfont-weight 700
ar-text-leftalign text left
ar-text-centeralign text center
ar-text-rightalign text right
ar-text-prettyprettier line breaks (text-wrap: pretty)
ar-text-wrapnormal wrapping (text-wrap: wrap)
ar-leading-tightline-height 1.25
ar-leading-6line-height 1.5rem
ar-tracking-wideletter-spacing 0.025em
ar-tracking-widerletter-spacing 0.05em
ar-underlineunderline the text
ar-no-underlineremove the underline
ar-list-noneno list bullets
ar-tabular-numseven-width numerals (tabular-nums)

Borders & rounded

Border width and sides, the radius scale, and the shadow ladder. Border width follows the theme (1px by default, 3px on neo, 2px on pixel).

Borders
ar-border ar-rounded
ar-border-2 ar-rounded-lg
ar-rounded-full
ar-shadow-lg
ClassDescription
ar-bordersolid border, theme width (1px by default)
ar-border-22px solid border
ar-border-ttop border, theme width
ar-border-t-0no top border
ar-border-bbottom border, theme width
ar-border-base-contentborder color: base-content
ar-border-neutralborder color: neutral
ar-border-gray-200border color: gray-200
ar-border-gray-300border color: gray-300
ar-border-base-300border color: base-300
ar-roundedradius 0.25rem (field)
ar-rounded-lgradius 0.5rem (box)
ar-rounded-xlradius 0.75rem
ar-rounded-boxradius 0.5rem (box)
ar-rounded-fullpill radius (9999px)
ar-shadow-smsm shadow
ar-shadow-mdmd shadow
ar-shadow-lglg shadow
ar-shadow-xlxl shadow
ar-shadow-2xl2xl shadow (largest)

Position, opacity & motion

Positioning helpers, z-index, opacity, transitions and a few odds and ends (ar-cursor-pointer ar-whitespace-nowrap ar-sr-only ar-scroll-smooth).

Position & opacity
ar-absolute ar-top-0 ar-left-5ar-opacity-30
ClassDescription
ar-relativeposition: relative
ar-absoluteposition: absolute
ar-fixedposition: fixed
ar-stickysticky header: top: 0 + z-index 50
ar-inset-0pin to all edges (inset: 0)
ar-top-0top: 0
ar-bottom-0bottom: 0
ar-left-0left: 0
ar-right-0right: 0
ar-top-1/2top: 50%
ar-left-5left: 1.25rem
ar-right-5right: 1.25rem
ar-z-10z-index 10
ar-z-20z-index 20
ar-z-50z-index 50
ar-opacity-0fully transparent
ar-opacity-3030% opacity
ar-opacity-6060% opacity
ar-transition-alltransition everything, 0.3s ease
ar-transition-transformtransition transform only, 0.3s ease
ar-duration-300transition duration 0.3s
ar-duration-500transition duration 0.5s
ar-ease-outease-out timing function
ar-ease-in-outease-in-out timing function
ar-cursor-pointerpointer cursor
ar-whitespace-nowrapnever wrap the text
ar-sr-onlyscreen-reader only (visually hidden)
ar-scroll-smoothsmooth scrolling — applied only when prefers-reduced-motion allows it

Hover states

One-shot hover helpers - hover only, no prefix to remember.

Hover
ar-hover-ringar-hover-bg-gray-100
ClassDescription
ar-hover-bounceon hover: bob up and down (1s loop)
ar-hover-scale-110on hover: scale to 110%
ar-hover-shadow-xlon hover: xl shadow
ar-hover-text-gray-600on hover: text gray-600
ar-hover-text-neutralon hover: text neutral
ar-hover-bg-gray-100on hover: background gray-100
ar-hover-bg-gray-700on hover: background gray-700
ar-hover-border-gray-400on hover: border gray-400
ar-hover-ringon hover: 1px gray-400 ring + border
ar-hover-ring-gray-200on hover: 1px gray-200 ring

Responsive

Three breakpoints: xs below 480px, md from 768px, lg from 1024px. Prefix any listed helper with ar-md:* or ar-lg:* (the colon, not a dash), or hide below 480px with ar-hide-xs.

Responsive
Resize me - stacks, then ar-md:flex-row
second
ClassDescription
ar-hide-xshidden below 480px
ar-md:flex≥768px: display flex
ar-md:flex-col≥768px: stack vertically
ar-md:flex-row≥768px: row direction
ar-md:hidden≥768px: display none
ar-md:grid≥768px: display grid
ar-md:grid-cols-2≥768px: 2 equal columns
ar-md:items-center≥768px: center on the cross axis
ar-md:w-1/2≥768px: width 50%
ar-md:w-1/3≥768px: width 33.3%
ar-md:w-2/3≥768px: width 66.7%
ar-md:max-w-52≥768px: max-width 13rem
ar-md:p-8≥768px: padding 2rem
ar-md:mx-0≥768px: horizontal margins 0
ar-md:text-left≥768px: align text left
ar-md:text-center≥768px: align text center
ar-lg:flex≥1024px: display flex
ar-lg:flex-col≥1024px: stack vertically
ar-lg:flex-row≥1024px: row direction
ar-lg:hidden≥1024px: display none
ar-lg:grid≥1024px: display grid
ar-lg:grid-cols-2≥1024px: 2 equal columns
ar-lg:grid-cols-3≥1024px: 3 equal columns
ar-lg:grid-cols-4≥1024px: 4 equal columns
ar-lg:items-center≥1024px: center on the cross axis
ar-lg:justify-between≥1024px: space between
ar-lg:gap-8≥1024px: gap 2rem
ar-lg:w-1/2≥1024px: width 50%
ar-lg:w-2/5≥1024px: width 40%
ar-lg:max-w-none≥1024px: no max width
ar-lg:max-w-lg≥1024px: max-width 32rem
ar-lg:p-8≥1024px: padding 2rem
ar-lg:p-16≥1024px: padding 4rem
ar-lg:mx-0≥1024px: horizontal margins 0
ar-lg:text-2xl≥1024px: font-size 1.5rem
ar-lg:text-4xl≥1024px: font-size 2.25rem
ar-lg:text-6xl≥1024px: font-size 3.75rem
ar-lg:text-8xl≥1024px: font-size 6rem
ar-lg:text-9xl≥1024px: font-size 8rem
ar-lg:leading-tight≥1024px: line-height 1.25
ar-lg:text-left≥1024px: align text left
ar-lg:text-center≥1024px: align text center

Animation

Entrance, loop and scroll-reveal helpers.

Entrance: add ar-animate-fade-in and stagger with style="--ar-delay: .2s". Loop: ar-bounce bobs an element up and down forever. Scroll reveal: put data-ar-reveal on any block — it fades up once when scrolled into view (IntersectionObserver in arekui.js, fires once, no configuration). All three settle to their final state under prefers-reduced-motion: reduce, and a page without JavaScript shows everything.

Animation

Fades up once when scrolled into view.

ClassDescription
ar-animate-fade-infade + slide in once, 0.4s (delay via --ar-delay)
ar-bounceloop a small vertical bob, 1s
ar-revealhidden start state for scroll reveal (the script adds it)
data-ar-revealattribute, not a class — the script reveals the block on scroll