Snapchat /Valdi
Valdi is a cross-platform UI framework that delivers native performance without sacrificing developer velocity.
★ 16,380⑂ 538👁 75⑃ 125● 68▤ 4
+0
Daily
16,380
stars
538
forks
75
watchers
125
prs
68
issues
4
releases
README
[!NOTE]
Beta Status: Valdi has been widely used in Snap's production apps for the last 8 years. We're calling this a beta because our tools and documentation need more battle testing in the open source world. Valdi will exit beta when we're happy with the developer experience.
Valdi is a cross-platform UI framework that delivers native performance without sacrificing developer velocity. Write your UI once in declarative TypeScript, and it compiles directly to native views on iOS, Android, and macOS—no web views, no JavaScript bridges.
Quick Example
A basic Valdi component:
tsx
import { Component } from 'valdi_core/src/Component';
class HelloWorld extends Component {
onRender() {
const message = 'Hello World! 👻';
;
}
}
Quick Start
Prerequisites: Node.js 20 or later (22 recommended) and, on macOS, Xcode 26.5 or 27. valdi dev_setup installs the rest. See the Installation Guide.
bash
Install Valdi CLI
npm install -g @snap/valdi
One-command setup (installs all dependencies)
valdi dev_setup
Create your first project
mkdir my_project && cd my_project
valdi bootstrap
valdi install ios or android
[!TIP]
Editor setup: No Valdi-specific extension is needed. See VSCode/Cursor setup to point your editor at the workspace TypeScript version.
Quick Links
- Getting Started Guide
- Documentation
- Codelabs
- API Reference
- Frequently Asked Questions
- Component Library
- GitHub Discussions
- Roadmap
Example Apps
The apps/ directory contains runnable examples:
| App | What it shows |
|-----|---------------|
| helloworld | Minimal component — the fastest way to get something on screen |
| navigation_example | Screen navigation patterns |
| managed_context_example | Sharing state across components with managed context |
| valdi_gpt | AI-driven dynamic UI — Valdi rendering UI described at runtime |
| cli_example | Building a Valdi CLI application |
| benchmark | Performance benchmarks |
Why Choose Valdi?
Valdi is a cross-platform UI framework designed to solve the fundamental problem of cross-platform development: velocity vs. runtime performance. For 8 years, it has powered a large portion of Snap's production apps.
True Native Performance
Unlike frameworks that rely on web views or JavaScript bridges, Valdi compiles declaratively rendered TypeScript components into platform-native views. Valdi also includes several other performance advantages:
- Automatic view recycling - Global view pooling system reuses native views across all screens, dramatically reducing inflation latency
- Optimized component rendering - Components re-render independently without triggering parent re-renders, enabling fast incremental updates
- Optimized layout engine - C++ layout engine runs on the main thread with minimal marshalling overhead
- Viewport-aware rendering - Only visible views are inflated, making infinite scrolling performant by default
Learn more in our Performance Optimization Guide.
Developer ExperienceTop issues
#4How to get started on windows? 7 comments · 2025-11-08#13WebSockets API support6 comments · 2025-11-10#6Support Linux as a target6 comments · 2025-11-08#94support for android 16 KB page size3 comments · 2026-04-07#24valdi install simulator argument3 comments · 2025-11-12#195valdi_ios_objc_test crashes intermittently: stack-use-after-scope in Hermes ES6 class transform1 comments · 2026-10-19#137Alternating Valdi test and web targets recompiles shared exec tools1 comments · 2026-08-04#95valdi vsix extensions can't be installed1 comments · 2026-04-26
Discussions
#194atolla: a jellyfin music player app2 comments · 2026-10-16#193Start here: getting started, getting help, and where to post0 comments · 2026-10-15#189Dart as declarative UI3 comments · 2026-09-22#143Hello Valdiers 💛2 comments · 2026-08-10#84Why can't I log in Snapchat0 comments · 2025-12-26#74So where can i find about Device hardware components access apis ?2 comments · 2025-12-02#66Make a snake game6 comments · 2025-11-25#56Can you publish a comparison between valdi and new architecture of react native?4 comments · 2025-11-21
Latest release
beta-0.2.1 beta-0.2.1 2026-10-19What's new A stability-focused release: runtime teardown and threading fixes, rendering fixes on iOS and Android, faster hot paths, and Xcode 27 support. Runtime stability - Hardened runtime teardown at app termination: JS dispatch is refused once the JS queue is torn down, visibility observers are no longer flushed into a destroyed context, and the native context stays retained across in-flight Java calls. - Deadline-bounded synchronous JS calls now fail fast while the JS thread is stalled instead of blocking the caller. - Fixed a race in the initial auto-render publication on Android. - P