Flow Field

`<pura-flow-field>` is a generative Canvas 2D backdrop in the Vanta TOPOLOGY family: particles drift along a seeded noise vector field behind the slotted content, drawing organic topographic lines that accumulate and slowly dissolve via a translucent trail fade. `preset="vortex"` swaps the noise field for a perturbed inward spiral around the center (the Aceternity Vortex effect on the same engine). The field is fully deterministic: `seed` picks the noise table and the particle spawn points, so the same seed always reproduces the same drawing. `scale` sets the field frequency (smaller is broader and smoother), `speed` the particle velocity, `fade` how fast old trails dissolve, and `line-width` the stroke width. One requestAnimationFrame loop integrates the particles and pauses while the element is offscreen; the simulation is pre-rolled so the canvas is already covered in trails on first reveal. The server renders static deterministic streamlines traced through the exact same field, so the backdrop is presentable before any JS runs; reduced motion freezes the canvas on a single fully accumulated frame. Theme it with `--pura-flow-field-color`, `--pura-flow-field-opacity` and `--pura-flow-field-bg`. Each instance registers in `window.__puraFlowFields` by `data-pura-id` with `{ preset, count, seed, pause, resume }`.

Preview

Attributes

AttributeTypeDefaultDescription
count number 500 Number of particles, max 1500.
preset "flow" | "vortex" flow flow steers particles by the noise field; vortex orbits them on a perturbed inward spiral around the center.
seed number 1 Noise seed. The same seed always produces the same field and the same drawing.
scale number 0.004 Noise field frequency per px. Smaller values give broader, smoother curves.
speed number 60 Particle speed in px per second.
fade number 0.04 Trail fade per frame, 0..1. Lower values keep longer accumulated trails.
line-width number 1 Stroke width of the trails in px.

Installation

pura is copy-paste and dependency-free. Load the whole library, or just this component.

HTML
<link rel="stylesheet" href="/pura/tokens.css">
<script type="module" src="/pura/lib/flow-field.js"></script>
JavaScript
import "./pura/lib/flow-field.js";

Slots

default
esc
AccordionDisclosure ActionAgent AffixLayout Agent CursorTools Agent HintAgent Alert DialogOverlay AlertFeedback Angle SliderForm Animated BeamAnimation App ShellLayout Aspect RatioDisplay AsyncAgent AudioDisplay AuroraDisplay Auto AnimateUtility Avatar GroupDisplay AvatarDisplay Back to TopNavigation BadgeDisplay BannerFeedback BarcodeDisplay Background BeamsAnimation Bento GridAnimation Gooey BlobsAnimation BlockquotePrimitives Blur TextAnimation Border BeamDisplay Bottom NavigationNavigation BoxPrimitives BreadcrumbNavigation BubblesAnimation BurgerNavigation Button GroupForm ButtonForm CalendarDate Card StackAnimation CardDisplay CarouselLayout CascaderForm CenterPrimitives ChartDisplay Chat BubbleDisplay Chat InputForm CheckboxForm Cipher HoverAnimation Circular TextAnimation Click SparkAnimation Clip RevealAnimation Code BlockDisplay CodePrimitives CollapsibleDisclosure Color PickerForm ComboboxForm Command RegistryAgent CommandNavigation CommentDisplay ConfettiAnimation Confidence MeterDisplay Container ScrollAnimation ContainerLayout Context MenuOverlay Cookie ConsentOverlay Copy ButtonDisplay Copy RegionAgent Count UpDisplay CountdownFeedback Coverflow CarouselAnimation CronForm CrosshairAnimation CursorAnimation Data TableDisplay Date PickerDate Date Range PickerDate Datetime PickerDate DeckAnimation DialogOverlay Diff MotionUtility DiffUtility Direction HoverAnimation DisclosureLayout DockNavigation Dot PatternAnimation DrawAnimation DrawerOverlay Dropdown MenuOverlay Dynamic IslandAnimation EmphasisUtility EmptyDisplay Expand CardAnimation ExplainAgent Floating Action ButtonLayout Falling TextAnimation FAQDisclosure FieldForm File DropzoneForm FireworksAnimation FlashlightAnimation FlexPrimitives Flickering GridAnimation Flip CardAnimation Floating WindowOverlay Flow FieldAnimation FlowDisplay Fly To CartAnimation Focus HoverAnimation FolderAnimation FormForm Fuzzy TextAnimation Gallery 3DAnimation GaugeDisplay Glitch TextAnimation Gooey CursorAnimation Gradient TextAnimation Grid MotionAnimation Grid PatternDisplay GridPrimitives HeadingPrimitives HeatmapDisplay Hide-on-scroll BarAnimation HighlightDisplay Hold ConfirmAnimation Holo CardAnimation HotkeyAgent Hover CardOverlay Hover HighlightAnimation Hover UnderlineAnimation IconDisplay IdleAgent Image CompareLayout Image TrailAnimation ImagePrimitives Infinite ScrollUtility Inline EditForm Input GroupForm Input OTPForm InputForm InspectorUtility IntentAgent Interactive GridAnimation ItemDisplay Json InputForm KanbanLayout Keyboard ShortcutsOverlay KbdDisplay KnobForm LabelForm Lamp EffectAnimation LensAnimation Letter ShuffleAnimation Light RaysAnimation LightboxOverlay Line Shadow TextAnimation LinkPrimitives ListDisplay Live RegionAgent Magic CardDisplay Magnet LinesAnimation MagneticAnimation MapDisplay Markdown EditorForm Marquee 3DAnimation MarqueeDisplay Mask InputForm MasonryLayout Matrix RainAnimation Media QueryUtility MentionForm MenubarNavigation Animated Mesh GradientAnimation MeteorsDisplay MeterDisplay MorphAnimation Motion BudgetUtility Motion PathAnimation MotionUtility Narrated TransitionUtility Navigation MenuNavigation Noise / Film GrainAnimation Notification ItemDisplay Number InputForm OptimisticAgent Orbiting CirclesDisplay Organization ChartDisplay Overflow ListLayout OverlayOverlay PaginationNavigation Parallax ColumnsAnimation ParallaxMarketing Particle NetworkAnimation ParticlesDisplay Password InputForm Pdf ViewerDisplay Scroll PinAnimation Pinch ZoomAnimation Pixel RevealAnimation Pointer ParallaxAnimation PopconfirmOverlay PopoverOverlay PortalAgent PresenceDisplay Pricing TableMarketing Progress RingDisplay ProgressDisplay Progressive BlurAnimation TypographyDisplay Pull To RefreshFeedback Pulse RingsAnimation Qr CodeUtility Radio GroupForm RadioForm Range SliderForm RatingForm ReactionsDisplay RedactAgent ResizableLayout ResultFeedback Retro GridDisplay RevealUtility Rich TextForm RippleUtility ScrambleAnimation Scroll AreaNavigation Scroll HighlightAnimation Infinite Scroll LoopAnimation Scroll ProgressNavigation Scroll RevealUtility Scroll SpyNavigation Scroll TimelineUtility Scroll ZoomAnimation Search FieldForm SectionPrimitives Segmented ControlForm SelectForm SeparatorDisplay Sheen / Glare HoverAnimation SheetOverlay SidebarNavigation SignatureForm Skeleton TextDisplay SkeletonDisplay Skip NavNavigation SliderForm Smooth Scroll (lerp)Animation SnowAnimation SortableAnimation SpacerPrimitives Sparkles TextAnimation SparklineDisplay Speed DialOverlay SpinnerDisplay Split ButtonOverlay Split-Flap TextAnimation Split TextAnimation SpotlightOverlay SpringAnimation StackPrimitives StageAnimation Starfield / HyperspaceAnimation Stat GridDisplay StatDisplay Status BadgeAnimation Step LoaderAnimation StepperNavigation Sticky Scroll RevealAnimation Stream CascadeUtility Swatch PickerForm SwipeUtility SwitchForm TableDisplay TabsNavigation Tag InputForm TagDisplay TerminalDisplay TestimonialDisplay Text FillAnimation Text HighlighterAnimation Morphing TextAnimation Text PressureAnimation Text ShimmerDisplay TextPrimitives TextareaForm Theme DesignerUtility Animated Theme ToggleAnimation TickerDisplay TiltAnimation Time PickerDate Time ScrubUtility TimelineDisplay ToastFeedback Toggle GroupForm ToggleForm ToolbarNavigation TooltipOverlay TourOverlay Tracing BeamAnimation TransferForm Tree SelectForm Tree ViewDisplay True FocusAnimation TruncateUtility Type MorphAnimation TypewriterDisplay Typing IndicatorFeedback UndoFeedback UploadForm Vanish InputAnimation Scroll Velocity MarqueeAnimation VelocityAnimation Video TextAnimation VideoDisplay View TransitionUtility Virtual ListDisplay Visually HiddenPrimitives WatermarkDisplay Wavy BackgroundAnimation Wavy TextAnimation WipeAnimation Word RotateAnimation