Further readingWhere to go for the long answers — design docs, per-crate READMEs, the GitHub repository, and the projects that inspired this one.
Sourcegithub.com/IdealystIO/idealyst-nativeThe whole framework, the CLI, the example apps, and this website. Open issues here; the issue tracker is the canonical place for bug reports and feature discussion.
Design documentsLong-form design rationale and reference material. These live in the `docs/` directory of the repo.docs/ui-layer.mdThe authoring surface: ui! / jsx! / #[component] / stylesheet! / Ref<H>. Read this for the day-to-day API.docs/reactivity.mdSignals, effects, derived signals, batched writes. The reactive layer end-to-end.docs/styling.mdStylesheets, variants, tokens, transitions. How the framework's styling system actually works.docs/animation.mdAnimatedValue<T>, spring + decay drivers, the per-frame write path. Declarative vs imperative motion.docs/backend.mdThe Backend trait contract — render walker rules, per-primitive lifecycle, what a backend must guarantee.docs/fonts.mdTypeface registration, fallback chains, per-platform font loading.
Per-crate READMEsWhen a crate has non-obvious wiring or behavioural quirks, it has its own README. The most useful entry points:crates/runtime/core/README.mdBackend trait, primitive vocabulary, render walker, reactivity internals.crates/runtime/macros/README.md#[component], ui!, jsx!, stylesheet! — the author-facing macros and what they expand to.crates/backend/web/README.mdScheduler / time-source bootstrap requirements, animated-value capabilities.crates/backend/ios/mobile/README.mdUIKit quirks the iOS backend works around (scroll bounds, intrinsic sizing, corner-radius clamping).crates/backend/android/mobile/README.mdKotlin runtime requirements, JNI integration, Android Views translation.crates/sdk/README.mdHow third-party SDKs (Maps, WebView, navigators) plug in via Element::External.
AcknowledgementsDioxus is another Rust cross-platform UI initiative. Idealyst's iOS and Android backends use Taffy, one of their tools, as the flex-layout engine. Idealyst's rendering approach is different from Dioxus's, but the work and the community over there is worth your attention either way.github.com/DioxusLabs/dioxusIdealyst's earlier React Native incarnation — the project's original form before this Rust rewrite — lives at github.com/IdealystIO/idealyst-framework.