Changelog

Release history

Unreleased

Added
  • Launcher pill — wrapping an app now starts with the page untouched and a corner toggle into the stage; app state survives the round trip. defaultActive prop and ref.setActive control it programmatically
  • Flag-based camera authoring with cross-engine flag pins
  • screenshotEndpoint prop for staging live-URL content as a rendered screenshot
Fixed
  • Mirrored yaw axis in the WebGL engine

0.1.0June 2026

First public release as @alstroemeria/iris. Wrap any React app in a cinematic camera frame, or run standalone and stage any URL, video, or image.

Added
  • Keyframe timeline — scrubbing, per-keyframe easing, loop, transport controls, and built-in cinematic camera patterns
  • Standalone content sources with smart embed URLs (YouTube, Vimeo, Loom, Figma, CodePen, CodeSandbox)
  • Pluggable render engines — the WebGL engine (@alstroemeria/iris/three) adds true bokeh DOF, focus-point falloff, and procedural scene presets while the default CSS engine stays three.js-free
  • Focus-point depth of field with bokeh, falloff, and tilt band angle
  • Scene templates — one-click bundled looks
  • Screenshot export (⌘⇧S) and programmatic video recording via recordElementWhile
Improved
  • Package renamed from parallax to @alstroemeria/iris
  • Vitest coverage for the pure core (easing, DOF, camera patterns, content URLs)