NoiseOverlay
Full-viewport static grain using an SVG feTurbulence (fractal noise) + feColorMatrix (desaturate) filter chain. Renders a fixed, pointer-events-none layer meant for a single use near the app root. Prefer opacity around 0.05–0.12 at normal zoom.
import { NoiseOverlay } from "phoundry-ui";Preview (exaggerated in this box)
Loading interactive example…
View source
<script lang="ts"> import { NoiseOverlay } from "phoundry-ui";</script>
<div class="relative h-32 overflow-hidden rounded-md border border-border-default bg-surface-raised"> <NoiseOverlay position="absolute" opacity={0.22} zIndex={0} /> <div class="relative z-10 flex h-full items-center justify-center p-3"> <p class="text-center text-xs text-txt-secondary"> Higher opacity here for visibility; the docs site root uses a lower value. </p> </div></div>Grain tuning
Loading interactive example…
View source
<script lang="ts"> import { NoiseOverlay } from "phoundry-ui";</script>
<p class="mb-2 text-xs text-txt-secondary"> Tuple <code>baseFrequency</code> stretches noise asymmetrically; <code>seed</code> stabilizes the pattern across hot reloads; try <code>blendMode</code> values like <code>overlay</code>, <code>multiply</code>, or <code>normal</code> to match your background.</p><div class="relative h-28 overflow-hidden rounded-md border border-border-default bg-surface-base"> <NoiseOverlay position="absolute" opacity={0.14} zIndex={0} baseFrequency={[0.85, 1.05]} numOctaves={4} seed={42} blendMode="overlay" /> <div class="relative z-10 flex h-full items-center justify-center px-3"> <span class="text-center text-xs text-txt-secondary" >Stronger grain + <code>overlay</code> blend for demo.</span > </div></div>Root layout
Mount once inside your top-level +layout.svelte (or app shell). Keep zIndex under your modal / tooltip layer; the component defaults to 1. The layer uses pointer-events: none so it never steals focus or clicks.
<script> import { NoiseOverlay } from "phoundry-ui";</script>
<div class="relative min-h-svh"> <NoiseOverlay /> <div class="relative z-10"> {@render children?.()} </div></div>API
From phoundry-ui@0.4.21
| Name | Type | Default | Description |
|---|---|---|---|
opacity | number | 0.08 | Layer alpha; keep low for a subtle look. |
zIndex | number | 1 | Stacking order; keep below your overlay / modal z-indexes. |
position | "fixed" | "absolute" | 'fixed' | Fixed = viewport; absolute = fill a relative/absolute parent. |
baseFrequency | string | number | [number, number] | 0.72 | feTurbulence frequency; one value or x/y pair. Higher = finer grain. |
numOctaves | number | 3 | Turbulence detail (typically 2–4). |
seed | number | — | Optional 0–999; fixes the pattern when you need a stable look across remounts. |
blendMode | string | 'soft-light' | CSS mix-blend-mode; soft-light and overlay are common for UI grain. |
class | string | '' | Extra classes on the fixed wrapper div. |
CSS styling
.ph-noise-overlay is the stable identification hook for NoiseOverlay. Part selectors and --_ph-* properties are internal. Component CSS is scoped and unlayered; Consumer classes remain additive and utility overrides may lose precedence.
Position uses data-position. Opacity, stacking, and blend-mode props keep their existing behavior.
Keep the shared component stylesheet and a named Theme imported. Decorative motion respects reduced-motion preferences.