Shared assets

Background elements

Decorative layers for hero and section backgrounds: patterns (Grid, Grid check, Grid dot, Tech grid), decorative shapes, overlays and masks. Place inside a relative container; layers ignore pointer events. Figma: Background elements.

import{ BackgroundPattern, BackgroundPatternDecorative, BackgroundOverlay } from "@pepulux/ui"

Pattern types — mask on

Grid
Grid check
Grid dot
Tech grid

Size and mask shapes

size sm (48px cells) or md (72px). mask: radial, ellipse, top, bottom, left, right, arch — or false for none.

radial
ellipse
top
bottom
arch
false

Decorative shapes

Overlay — over imagery

Props

PropTypeDefaultDescription
type (BackgroundPattern)"grid" | "grid-check" | "grid-dot" | "tech-grid""grid"Figma Type
size"sm" | "md""md"Figma Size — 48px or 72px cells
maskboolean | "radial" | "ellipse" | "top" | "bottom" | "left" | "right" | "arch"trueFigma Background mask — fade toward the edges
colorstringvar(--n-300)Stroke colour
type (Decorative)"circles" | "squares" | "dots""circles"Figma Background pattern decorative
direction (Overlay)"top" | "bottom" | "left" | "right" | "radial""bottom"Direction the gradient fades toward
tone / intensity"dark" | "light" | "brand" / number"dark" / 0.6Overlay colour and strength (0–1)
Shared asset → Background elementswww.pepulux.com

Notes and documentation

Space for notes, documentation, and best practices for using these components.

Texture without noise

Patterns, shapes and overlays add depth to hero and section backgrounds. Keep them faint and mask them toward the edges so they never compete with the content.

Use overlays to keep text readable on top of photography.

Do

  • Decorate with one pattern per section

Don't

  • Place patterns behind dense text or forms