tidos 0.7.6

Tidos is a component framework that can be served by any web framework.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# Tidos
[![License](https://img.shields.io/crates/l/tidos)](LICENSE)
[![Download](https://img.shields.io/crates/v/tidos)](https://crates.io/crates/tidos/)
[![API Docs](https://img.shields.io/badge/documentation-tidos-blue)](https://docs.rs/tidos/latest/tidos/)
[![Coverage](https://codecov.io/gh/kaasbroodju/tidos/branch/main/graph/badge.svg)](https://codecov.io/gh/kaasbroodju/tidos)

Tidos is a high-performance Rust-based component framework that seamlessly integrates with any web framework, enabling developers to build dynamic web applications with ease. With Tidos’ powerful macros, you can intuitively create components directly within your Rust code. It even allows you to leverage Rust's pattern matching, loops, and conditionals inside your components—making your UI logic more expressive and maintainable.

```rust
use tidos::view;

let names = vec!["Bob", "Alice"];

view! {
    {#for name in names}
        <p>{format!("Hello {}!", name)}</p>
    {/for}
}
```

## Examples
### A simple example
```rust
use tidos::{view, Component, Page};

pub struct Greet {
    pub name: String,
}

impl Component for Greet {
    fn to_render(&self, page: &mut Page) -> String {
        view! {
            <section>
                <h1>Hello {&self.name}!</h1>
                <p>Welcome to Tidos.</p>
            </section>
        }
    }
}

// Example route from Rocket, but you can use any framework you want.
#[get("/")]
pub fn index() -> Page {
    use tidos::{page, Component, Page};

    page! {
        <Greet name={String::from("kaasbroodju")} />
    }
}
```

### More examples
- Runnable examples can be found in the [`examples/`](examples/) folder.
- For API documentation visit [docs.rs/tidos](https://docs.rs/tidos/latest/tidos/).
- For extra context for your ai-assistent check out Tidos' [Claude skills](.claude/skills/tidos/SKILL.md).

## Getting help
If you're stuck or need help, reach out to the community via [our Github discussions](https://github.com/kaasbroodju/tidos/discussions).

## Contributing
Contributions are absolutely, positively welcomed and encouraged! If you're
interested in contributing code or documentation, please first read the [code of conduct].

Additionally, you could:
1. Submit a feature request or bug report as an [issue].
2. Ask for improved documentation as an [issue].
3. Answers questions in [GitHub discussions questions].
4. Share a project in [GitHub discussions show & tell].

[issue]: https://github.com/kaasbroodju/tidos/issues
[code of conduct]: CODE_OF_CONDUCT.md
[GitHub discussions questions]: https://github.com/kaasbroodju/tidos/discussions/categories/q-a
[GitHub discussions show & tell]: https://github.com/kaasbroodju/tidos/discussions/categories/show-and-tell

## License

This project is licensed under the [GNU Lesser General Public License v3.0 (LGPL-3.0)](LICENSE).