hirola 0.4.0

Hirola is an un-opinionated web framework that is focused on simplicity and predictability
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

# Hirola

[![Latest Version](https://img.shields.io/crates/v/hirola.svg)](https://crates.io/crates/hirola)
[![Browser Tests](https://github.com/geofmureithi/hirola/actions/workflows/browser.yml/badge.svg)](https://github.com/geofmureithi/hirola/actions/workflows/browser.yml)
[![Unit Tests](https://github.com/geofmureithi/hirola/actions/workflows/unit.yml/badge.svg)](https://github.com/geofmureithi/hirola/actions/workflows/unit.yml)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)

**Hirola** is a declarative frontend framework that is focused on simplicity and reactivity.

## Goals

1. KISS: A simple and declarative way to build frontend UIs in rust.
2. Make it easy to read, extend and share code.
3. Frp signals allowing fine-grained reactivity.
4. Familiarity: Uses rsx which is very similar to jsx.

## Example

We are going to create a simple counter program.

```bash
cargo new counter
```

With a new project, we need to create an index file which is the entry point and required by trunk

```bash
cd counter
```

Create an `index.html` in the root of counter. Add the contents below

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <title>Hirola Counter</title>
  </head>
  <body></body>
</html>
```

Lets add some code to `src/main.rs`

```rust,no_run
use hirola::prelude::*;
use hirola::dom::*;

fn counter() -> Dom {
    let count = Mutable::new(0i32);
    let decrement = count.callback(|s| *s.lock_mut() -= 1);
    let increment = count.callback(|s| *s.lock_mut() += 1);
    html! {
        <>
            <button on:click=decrement>"-"</button>
            <span>{count}</span>
            <button on:click=increment>"+"</button>
        </>
    }
}
fn main() {
    hirola::dom::mount(counter()).unwrap();
}
```

Now lets run our project

```bash
trunk serve
```

## Ecosystem

Check out [Hirola Docs](https://hirola-docs.vercel.app/basics/getting-started) written with Hirola itself!

Here are some extensions for hirola:

1. [Form](https://hirola-docs.vercel.app/plugins/form)
2. [Router](https://hirola-docs.vercel.app/plugins/router)
3. [State](https://hirola-docs.vercel.app/plugins/state)
4. [Markdown](https://hirola-docs.vercel.app/plugins/mdx)

### Milestones

| Status | Goal                               | Labels    |
| :----: | :--------------------------------- | --------- |
|   ✔    | Basic templating with rust and rsx | `ready`   |
|   ✔    | Extend functionality with mixins   | `ready`   |
|   ✔    | Components                         | `ready`   |
|   ✔    | SSR                                | `ready`   |
|   ✔    | Signals                            | `ready`   |
|   🚧   | Form management                    | `started` |
|   ⏳   | Markdown templating                | `pending` |
|   🚧   | Styling                            | `started` |
|   ⏳   | SSG                                | `pending` |