Skip to content

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
preview-exaggerated-in-this-box.svelte
<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
grain-tuning.svelte
<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

NameTypeDefaultDescription
opacitynumber0.08Layer alpha; keep low for a subtle look.
zIndexnumber1Stacking order; keep below your overlay / modal z-indexes.
position"fixed" | "absolute"'fixed'Fixed = viewport; absolute = fill a relative/absolute parent.
baseFrequencystring | number | [number, number]0.72feTurbulence frequency; one value or x/y pair. Higher = finer grain.
numOctavesnumber3Turbulence detail (typically 2–4).
seednumber—Optional 0–999; fixes the pattern when you need a stable look across remounts.
blendModestring'soft-light'CSS mix-blend-mode; soft-light and overlay are common for UI grain.
classstring''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.

Documentation is licensed under CC BY 4.0. Phoundry names and marks remain reserved.