Expo Svelte
GitHub
src/routes/+mobile.svelte
<script lang="ts">
	import { Circle, Defs, Rect, Screen, Stop, Svg, SvgLinearGradient, SvgText } from 'expo-svelte';
</script>

<Screen title="SVG">
	<Svg width={96} height={64} viewBox="0 0 96 64">
		<Defs>
			<SvgLinearGradient id="card" x1="0" y1="0" x2="1" y2="1">
				<Stop offset="0" stopColor="#ff7a18" />
				<Stop offset="1" stopColor="#319197" />
			</SvgLinearGradient>
		</Defs>
		<Rect width="96" height="64" rx="12" fill="url(#card)" />
		<Circle cx="24" cy="32" r="6" fill="#fff" />
		<SvgText x="48" y="38" fill="#fff" fontSize="14" fontWeight="bold">SVG</SvgText>
	</Svg>
</Screen>

Expo Svelte carries react-native-svg (version 15.15.4) itself, so every app has it and none installs it: it is not a dependency of your app, and expo-svelte doctor checks the copy. Unlike the other native views, it needs no separate install.

Elements

Kind Components
Root Svg
Shapes Rect, Circle, Ellipse, Line, Polygon, Polyline, Path
Text SvgText, TSpan, TextPath
Structure G, Defs, Use, Symbol, SvgImage, ForeignObject
Paint SvgLinearGradient, RadialGradient, Stop, Pattern, Mask, ClipPath, SvgMarker
Filters Filter, FeBlend, FeColorMatrix, FeComposite, FeDropShadow, FeFlood, FeGaussianBlur, FeMerge, FeMergeNode, FeOffset
Documents SvgXml, SvgUri

react-native-svg calls its text and image elements Text and Image, which are the names of the Text and Image views. Here they are SvgText and SvgImage. Two more get an Svg prefix because expo-svelte/foreign has components of the same names (expo-linear-gradient's LinearGradient and the map's Marker): react-native-svg's are SvgLinearGradient and SvgMarker. Every other element keeps its name.

Inside a Text or TextPath, a string is a text span of its own. Whitespace between elements counts as text, as in HTML.

Drawing a document

SvgXml draws an SVG document from a string, and SvgUri from a URL, a file or a data URI. This is the way to use icons exported from a design tool:

svelte
<script lang="ts">
	import { SvgXml } from 'expo-svelte';

	const check = `<svg viewBox="0 0 24 24"><path d="M20 6 9 17l-5-5" fill="none" stroke="#191b1e" stroke-width="2"/></svg>`;
</script>

<SvgXml xml={check} width={24} height={24} />

Both take onError and a fallback snippet, shown when the document can't be drawn; SvgUri also calls onLoad once the document has loaded. Style sheets inside the document (SvgCss) aren't supported.

The ref handle

An element's ref gets a handle with the library's geometry functions: getBBox(options), getTotalLength(), getPointAtLength(length), isPointInFill({ x, y }), isPointInStroke({ x, y }), getCTM() and getScreenCTM(). The results are plain objects. The Svg's handle also has toDataURL(callback, options), which renders the drawing to a base64 PNG.

svelte
<script lang="ts">
	import { Path, Svg, type SvgHandle } from 'expo-svelte';

	let length = $state(0);
</script>

<Svg width={100} height={40}>
	<Path d="M0 20 Q50 0 100 20" stroke="#000" fill="none" ref={(handle: SvgHandle | null) => { if (handle) length = handle.getTotalLength() ?? 0; }} />
</Svg>

Animation

animatedProps on any element is a worklet that returns the props to animate. It runs on the UI thread and reads shared values, as animatedStyle does on an AnimatedView:

svelte
<script lang="ts">
	import { Circle, Svg, createSharedValue, withRepeat, withTiming } from 'expo-svelte';

	const radius = createSharedValue(6);
	radius.value = withRepeat(withTiming(12, { duration: 800 }), -1, true);
</script>

<Svg width={48} height={48}>
	<Circle cx="24" cy="24" r="6" fill="#0091ff" animatedProps={() => { 'worklet'; return { r: radius.value }; }} />
</Svg>

Animate numbers (r, cx, strokeDashoffset, opacity), a path's d, or a colour (fill, stroke) given as a CSS string such as '#ff8000' or 'rgba(0, 128, 255, 0.5)'.

Touches

Elements take onPress, onLongPress, onPressIn and onPressOut. On Android, a touch inside an Svg goes to the native view and never reaches JavaScript, so a shape's onPress doesn't run there. To make a drawing tappable on both platforms, give the Svg pointerEvents="box-only" and put onPress on the Svg itself, or wrap it in a Pressable.

Type to search the guide.