The pages are not a second copy of the documentation. They are the repository's own —
docs/getting-started.md, the guide under docs/guide/, the architecture notes and the
frus command's reference — copied in when the site is built. Each example in them is still
a complete piece of Rust that frus's test suite compiles, so what you read here is what
compiles today.
What you will find:
frus command, make a project, and
run it on this computer, a phone and the browser.frus is pre-alpha. If something on these pages is wrong, unclear or missing, each documentation page has a link to edit it on GitHub, and issues are open — in English or in French.
]]>Notifications with buttons, a picture and the system's sound, on the desktop, on Android (with its permission) and on the web. A tray icon with its menu; the taskbar's badge and progress; global shortcuts; the system's file dialogs; files dropped onto the window. Each one sits behind a feature of its own, and each is declared from the state.
Each widget is found where it is drawn and named by what it shows, and a reader can press it, tick a box and fill a field. On the web, a text field is edited through a real one — the phone's keyboard, composition for Chinese, Japanese and Korean, dictation — and read once.
frus run -d iphone-15 # in a window, on Windows, Linux or macOS
frus run -d iphone-15 --web # the same, in a browser
A debug build is laid out for the device's screen: its size and density, its safe areas, its
cutout, its keyboard and its orientation, drawn inside the device's outline. iPhone SE, iPhone 15,
iPhone 15 Pro Max, an iPad and an Android phone are built in, and a project can describe its own
in Cargo.toml.
Lottie animations arrive with the new frus-lottie crate. SVG pictures and Lottie animations can
be loaded from an address, embedded bitmaps included. frus now ships its own copy of glyphon as
frus-glyphon, so text draws on the Android emulator and on devices without Vulkan.
Badge::label_visible(false) now takes the badge away instead of leaving a dot, and the
navigation bars' counts stop at 999+, not 99+.
The changelog has every entry.
[dependencies]
frus = "0.5"
frus command grows from creating a project into the whole
loop, true hot reload on every platform included. Applications start faster and survive a lost
GPU, and pictures are decoded at the size they are shown.
frus commandfrus devices, frus run (with r to reload keeping the state, R to restart, and keys for
the widget tree, the performance graphs and screenshots), frus build, frus test,
frus analyze, frus doctor, frus emulators, frus daemon for editors, and a VS Code
extension. Each command installs what it needs and the machine lacks.
frus run --hot patches each saved change into the running application and keeps its state,
on Windows, Linux, macOS, Android and the web.
The first frame's time is logged. Windows starts in 0.6–0.8 s with DXC, down from 1.3–2.0 s. Pipelines are kept between launches where the GPU allows, which takes the test phone to 0.33 s from the second start. A lost GPU device is replaced and the application goes on, and devices without Vulkan draw through OpenGL ES.
Pictures are decoded at the size they are shown: a photograph's thumbnail holds 0.3 MB, not
46 MB. Large ones are decoded off the interface's thread, and memory is given back when the
system runs short. SVG pictures draw as vector paths, through the new frus-svg crate.
An Image::memory or Image::network resolves its pixels when it is first laid out, not when
it is built. PathGradient is no longer Copy.
The changelog has every entry.
Center and Aligned, the single-purpose boxes, GestureDetector, MouseRegion, Listener,
OrientationBuilder, LimitedBox, AnimatedSize, AnimatedCrossFade, SizeTransition,
CustomMultiChildLayout, StickyHeader, SelectionArea and selectable text.
The buttons, Container, the checkbox, the radio, the switch (its thumb can be dragged now), the
stack, the progress indicators, the app bar, CircleAvatar and Slider were each checked for
what they do, not only for their names. Visual density came with them.
BoxDecoration in full: shapes, sides, lists of shadows and blur styles; linear, radial and
sweep gradients; pictures (DecorationImage); and the background's blend mode, with 29 blend
modes.
Each widget knows which platform's conventions it follows. This release adds scroll behaviours, page transitions, the iOS back swipe, an Apple theme, and a desktop menu bar (on Windows, on the title bar's line). Scroll physics gained never-scrollable and always-scrollable modes.
Frame statistics, logs in every platform's console, and an application template that builds and ships to every platform.
The entries marked Changed in the changelog say what breaks, and how to move.
[dependencies]
frus = "0.3"
cargo add frus
The release exists because a version number on crates.io cannot be rewritten. Since the
0.2.0 tag, master had gained web accessibility, and the crates had gained their publishing
metadata. Publishing 0.2.0 from master would have shipped something other than the tag, so
the new code went out as 0.2.1.
Ten crates carry their repository, documentation, keywords and categories, and every path
dependency between them names a version. The sample applications stay unpublished. A dry run of
cargo publish --workspace orders the crates by their dependencies (frus-core first, frus
last) and builds each one from its packaged tarball.
A screen reader can now navigate the demo's task list in a browser, and operate it. Every
semantic node is a real, focusable element placed in the canvas's fallback content, so Tab and
assistive technology reach it. Announcements go through an aria-live region.
On the way, we found and fixed a bug on every platform. A clickable control merged with its caption was announced correctly, but did nothing when activated, through AccessKit on the desktop as much as on the web. This was checked against a real browser's computed accessibility tree.
]]>StatelessWidget; StatefulWidget with a State; hooks (use_state, use_effect,
use_interval, use_text_controller…); TextEditingController, ChangeNotifier and
ValueNotifier. Then there is FrusApp, an application that is a root widget and whatever it
builds: no message type, no update, no view. The message-based Application is still
there, and FrusApp is one. A host module lets a component change what is not a widget: the
theme, the language, the zoom, a focus, a scroll, work for another thread.
GoRouter holds routes named by a pattern of path. It has go, push, replace and pop,
path parameters and queries, redirects, page transitions and the back gesture. On the web, its
location is the address bar: a page opens at #/users/42, the browser's back and forward
buttons move the application, and a reload comes back to the same page. Android reads its
launch link, and a desktop reads its argument.
A restyle of the core widgets: buttons, chips, cards, dividers, the app bar, tabs, navigation.
New widgets: DataTable::lazy, DropdownMenu, SearchAnchor, ToggleButtons,
ExpansionPanelList, ReorderableList, a picker wheel, DraggableScrollableSheet and the whole
Material icon set. New motion: implicit animations, explicit transitions, AnimatedSwitcher,
sheets that follow the finger, and drag to reorder that scrolls the list under it.
Selection handles, autofill hints, the clipboard on Android and in the browser, emoji, and the focused field brought back above the soft keyboard. The device's language, and on Android the reader's font size, night mode and reduced motion, reach the application.
All fifteen crates refuse a missing doc comment. Every crate's README example is compiled as a
doctest, the minimum supported Rust version is pinned, and the smallest application has a size
budget in CI. cargo test --workspace runs 2,550 tests, up from 717 at 0.1.0.
A good deal, as the release moves the API. Variant::Primary and Variant::Secondary became
Variant::Filled and Variant::Outlined. Scaffold no longer scrolls its body, AppBar::new()
takes no title, and every Navigator page has a key.
The changelog says what to change
for each one.
fetch included.An application is update and view. update is pure and synchronous, every effect goes
through a Command, and every long-lived stream through a Subscription. That is what lets 717
tests run with no GPU and no window. A single frus::main! declaration generates the desktop,
Android and web entry points, and an application declares one dependency, frus.
A wgpu renderer draws rounded rectangles, borders, shadows, gradients, vector paths, images, clips and layers. Layout is flexbox and grid over taffy, and text is shaped by cosmic-text, bidirectional scripts included. Around 80 widget modules ship: text fields, data tables, an editable grid, charts, date and time pickers, a kanban board, trees, toasts, modals and drawers. Every one is themed from a Material 3 colour scheme, and every style can be overridden.
Fluent translations with right-to-left layout, a semantics tree for screen readers, and
frus-test for headless rendering and golden images (87 at the time).
Nothing is on crates.io, the web has no clipboard or accessibility yet, and iOS compiles but does not run.
]]>