Documentation
For AI agents: this page is Markdown at https://squiggle.sh/docs.md. Every docs page is listed at https://squiggle.sh/llms.txt, and all of them are one file at https://squiggle.sh/llms-full.txt.
Squiggle tests, profiles and debugs your React Native or React web app from the inside. It sees which component is on screen, what it rendered and what a tap set off, so your tests survive a redesign and a slow screen points at the code that made it slow.
Start here
Setup takes one command, one edit to your root component and one rebuild. After that, your first flow takes a few minutes. A React web app needs no setup at all.
- Set up your appInstall Squiggle, run squiggle init, and rebuild once.Set up
- Your first flowRun the flow init wrote, then record one of your own.Write a flow
- A React web appOpen it in a Chrome window of Squiggle’s own, with nothing added to your project.React web apps
Not ready to install? Try Studio in your browser first, on a demo app.
What you can do
- Test journeysFlows in YAML that find controls by what they are, and keep passing when the layout changes.Write flows
- Describe a step as a goalYour coding agent works out the steps once. Every later run replays them.Agentic flows
- Find what is slowFindings that name the component, the request or the render behind a slow screen.Performance
- Inspect a componentPoint at anything on screen to see its props, state and the line that renders it.Inspector
- Replay a sessionRecord a session, play it back, and keep the seconds before a crash.Record and replay
- See how people use itA heatmap, rage taps and funnels, with no events to add by hand.Analytics
Your coding agent can do all of this too, through Squiggle’s MCP server. See Connect your agent.
What it runs on
- An Apple Silicon Mac with macOS 15 or later, and Xcode for iOS apps.
- A React Native app you can rebuild: an Expo development build or a bare React Native app. Expo Go can’t load the SDK.
- Or a React web app (React 18.3 or later) on its dev server, and Chrome, Chromium or Edge, on a Mac or on Linux (x64 or arm64).
- iOS apps in the simulator, React Native macOS apps and React web apps in Chrome. Squiggle doesn’t drive Android apps.
- In a Niteshift task, the
squigglecommand runs on Linux and drives your iOS app on the task’s simulator; see Niteshift tasks.