rva_flutter

The Flutter adapter for RVA (Responsive Visual Asset). It binds the shared Rust core over dart:ffi and renders the resolved scene with a Flutter CustomPainter.

The core decides what to draw (deterministic geometry for a viewport); Flutter decides how.

Platforms

Android, iOS and macOS. The core ships as a prebuilt binary via the plugin's platform folders (librva_ffi.so for Android, the dynamic RVAFFI.framework for Apple) — no toolchain or build step is required in your app.

Install

flutter pub add rva_flutter

Usage

import 'package:flutter/services.dart';
import 'package:rva_flutter/rva_flutter.dart';

// Render a bundled asset.
final bytes = (await rootBundle.load('assets/hero.rva')).buffer.asUint8List();

RVAImageView(bytes: bytes);

Lower-level Dart API (dart:ffi over the C ABI):

final image = await RVAImage.openSource('/path/hero.rva'); // path | file:// | http(s)://
print(image.describe());

final scene = image.resolveJSON(1280, 720);   // ResolvedScene JSON
final bytes = image.resource('bgLandscape');   // raw resource bytes
image.close();

Member	Description
`RVAImage.open(bytes)`	Parse + validate a `.rva` from bytes.
`RVAImage.openSource(src)`	Load from a path, `file://` or `http(s)://` URL.
`describe()`	Human-readable asset summary.
`resolveJSON(w, h)`	Deterministic `ResolvedScene` JSON for a viewport.
`resource(id)` / `hasResource(id)` / `relativeFor(id)`	Resource helpers.
`close()`	Release the native handle.

The core

The native core is provided by the airovo/rva repository and is the same C ABI used by the Swift, Kotlin and React Native adapters. For local development against a freshly built core, set RVA_FFI_LIB to the library path.

License

MIT — see LICENSE.

RVA — Responsive Visual Asset, built by Airovo Technologies.