Version 5.22.0

5.22 released June 16 2026

SPECS developers:
Important: The following is for SPECS 27, and not Spectacles (2024). Spectacles (2024) users should continue using Lens Studio 5.15.xx.

NEW

• CLAD (Closed Loop Agentic Development)

  • CLAD is a closed loop agentic development framework for Lens Studio and SPECS that allows developers to prototype, iterate, test, debug and more with proprietary agents built by the SPECS team for preferred IDEs

  • You can use the Specs Experience Builder to one-shot an entire Lens, or invoke various skills and agents individually to speed up your existing workflows.

  • New capabilities include: moving and interacting with the preview panels, checking the Lens' runtime states, optimizing existing Lenses, migrating Lenses to the new SPECS, and even writing Editor and Plugin code.

  • Add CLAD to your existing AI harness by following the instructions in the GitHub.

• LEAF (Lens Evaluation & Automation Framework)

  • A new integration-testing framework for Specs lenses. Write test scenarios in typescript to simulate user actions and then assert against the live scene state to verify Lens behavior.

  • Run them directly in preview through the LEAF plugin panel (Window > LEAF) or via MCP tools. Accessible via CLAD skill: live-lens-tester.

• Debugger (experimental)

  • Live JavaScript debugging with breakpoints.

  • Supported targets: SPECS 27 device, ‘No Simulation' preview panel, and ‘Horizontal' preview panel.

  • Supported clients: VS Code built-in debugger, Cursor built-in debugger, or Any other VS Code fork.

  • No setup needed. Just open the same project in Lens Studio and the debug client, and attach a built-in debugger.

Everyone:

NEW

• YAML Graph Files

  • Binary file formats related to graph editors have been deprecated. Loading a project or importing a package in 5.22 and later will automatically convert binary graph files to their new YAML format.

  • The new files can be edited directly with an external text editor or AI. Saved changes are reflected in the project immediately. Accessible via CLAD skills: shader-graph-skill and vfx-graph-skill.

  • For version controlled projects, expect to see graph-related diffs when upgrading to 5.22. Binary graphs will be removed and replaced by YAML-encoded files. This is a one-time conversion and no other action is required.

  • Binary → YAML format list

    • .ss_graph → .graphShader

    • .vfxgraph → .graphVfx

    • .lsscript → .graphScript

    • .subgraph → .subgraphCommon

    • .subgraph_vfx_spawn → .subgraphVfxSpawn

    • .subgraph_vfx_update → .subgraphVfxUpdate

    • .subgraph_vfx_output → .subgraphVfxOutput

• VFX

  • Particle Orient Node

    • Consolidates Billboard, Velocity Align, and Look At into one place, plus an Advanced mode for custom forward/up axes and a Rotation Angle input. Unlocks previously impossible orientation combinations across both quads and 3D meshes, without custom subgraphs or Code-node workarounds. Replaces the now-deprecated Align to Camera (Quad) node.

  • Particle Pivot Node

    • New node for offsetting a particle's rotation pivot, so artists can build hinged motion or any rotation that shouldn't pivot around the particle's center.

  • Particle Scale Node

    • New Output node allows users to edit non-uniform particle scale on quads and 3D meshes.

• Font and Icon panel

  • Search for fonts and icons that you can use in your Lens. Open the new panel by going to to Window > Fonts and Icons.

  • Accessible via CLAD skills: font-selector and icon-selector.

• Easy Lens / Lens Studio AI:

  • Core3D

    • Build interactive 3D Lens experiences with support for cameras, meshes, lights, physics, ray-casting, joints, procedural geometry, and GLB import.

    • Example prompts:

      • Create a simple 3D racing game

      • Create a 3D visualization of the solar system floating above the user's palm

      • Create a simple 3D game where my Bitmoji needs to run towards the end while evading moving obstacles

  • The Artistic Makeup block

    • Customize makeup looks with editable elements such as blush, brows, eyeliner, eyeshadow, freckles, lips, and lashes.

    • Example prompts:

      • Add artistic makeup

      • Add makeup with shapes

  • Face Enhancement block

    • Apply beautification effects with multiple Beauty ML variations for smoother, more polished face looks.

  • User Portrait

    • Isolate the person with segmentation for portrait-focused Lens effects.

  • Video Controls UI

    • Add native controls for playing and scrubbing multi-clip video sequences.

IMPROVEMENTS

• VFX

  • Pause When Not Visible

    • New checkbox on the Spawn container, when enabled, VFX simulations automatically freeze when the system leaves the camera frustum and resume on re-entry, cutting GPU cost for off-screen effects in scenes with many VFX systems.

  • Dynamic VFX culling bounds

    • World space culling volumes can now follow moving objects at runtime with worldBoundsCenter and cullingBoundsSize.

  • Scale With Scene Object

    • A New checkbox on the Spawn container makes particles automatically scale with their parent SceneObject's transform.

• Scene Editor

  • Collapsing Toolbar

    • When the scene editor viewport is narrowed, tools will hide and be newly accessible from a familiar double chevron button. Shortcuts will also now be available even if the tool is hidden.

  • Material/Texture Mesh Drops

    • Materials and Textures can now be dragged and dropped onto meshes in the Scene window.

  • Hide Joint/Rig Visualization

    • Joint/Rig visualizations can now be hidden by clicking the gear icon in the scene window toolbar and then toggling "Show Joint Visualization"

  • New Layout Rect Tool

    • When selecting Text, Text3D, or Canvas, a Layout Rect tool button will appear in the Scene editor's toolbar. When selected, or by pressing "U", a layout rect visualization will appear in the Scene editor and allow you to modify the layout rect by dragging on the sides or corners.

• Bitmoji Stickers and Selfies, and Friends Carousel components can now be used alongside Leaderboard Module Connected Lens Module, and other restricted APIs, as FriendsComponent is now optional.

• Friends Component now supports SafeSnapchatUser.

• Easy Lens / LS AI:

  • Face Swap fixes.

  • Joystick fixes.

  • Leaderboard fixes.

  • Bitmoji Head can be edited now.

• [Specs] Runtime Bundle (prfb) Exporter

BUGS FIXED

• Fixed issue for VFX when Particles don't scale properly

• Fixed issue when prefab can be destroyed after unpack

• Fixed stability and performance for big project with updated components

• Fixed issue when Undo does not revert keyframe edits — undoes AnimationPlayer setup steps instead

• Fixed issue when shader assets were not updated correctly after reimport

• Fixed issue when 3d models import can not be compressed

• Fixed broken Bitmoji finger animation from LS animation plugins

Windows 11 (64 bit); MacOS 12.0+

Minimum of Intel Core i3 2.5Ghz or AMD FX 4300 2.6Ghz or Apple M1 with 8 GB RAM; Intel HD Graphics 5000 / Nvidia GeForce 760 / AMD Radeon HD 5570 or better; screen resolution of 1280x768 or higher

Please make sure that you have the latest driver for your specific graphics card installed