Viewy Rust Documentation

Welcome to the Viewy documentation! Viewy is an innovative web UI toolkit designed with the modern developer in mind. If you've ever wished for a seamless blend of the power and flexibility of a design system, with the ease and simplicity of an UI library, then Viewy might just be what you've been looking for.

Why Choose Viewy?

• Simplicity: Viewy has an intuitive and expressive API that makes it easy to generate UI components.

• Customizability: A unique feature of Viewy is its configurability through the Viewy.toml file. This provides developers the flexibility to fine-tune the appearance and behavior of components, without having to dig deep into the codebase.

• Rich Component Library: From buttons and cards to navigation bars, Viewy offers a wide variety of components that cater to most web development needs.

Quick Start

Getting started with Viewy is easy. Here's a small snippet to showcase how you can generate a webpage with a button:

use viewy::prelude::*;

#[derive(Component)]
struct MyPage {
    pub btn_label: String
}

impl Component for MyPage {
    fn render(self) -> Node {
        View::new().append_child({
             Button::new(&self.btn_label, ButtonStyle::Filled)
         })
            .into()
    }
}
fn main() {
Page::with_title("Test")
    .with_content({
        MyPage {
            btn_label: "Hello".to_string()
        }
    })
    .compile(RenderMode::Complete);
}

In this example, a page with the title "Test" is generated, and a filled-style button with the label "Hello" is appended to it.

Customizing with Viewy.toml

Most of Viewy's components can be customized using the Viewy.toml configuration file. By specifying your design tokens in this file, you can achieve a consistent look and feel across your web application, without the repetitive code.

For detailed guidelines on using the Viewy.toml file, refer to the documentation of the Config struct.

As you navigate through this documentation, you'll discover more advanced features, tips, and best practices to make the most of Viewy. Dive in, and happy coding!