No description
Find a file
2022-10-12 14:43:42 -04:00
docs Fix dimensions and add .gitignore 2022-10-11 21:39:05 -04:00
examples Remove version numbers from examples 2022-10-12 14:43:42 -04:00
leptos 0.0.5 2022-10-12 14:17:57 -04:00
leptos_core Revert ahash version to prevent build issues on WASM 2022-10-12 14:13:42 -04:00
leptos_dom Update all libraries and examples to use new set_x API 2022-10-08 20:39:13 -04:00
leptos_macro 0.0.4 update 2022-10-12 08:38:04 -04:00
leptos_reactive Adding lots of docs 2022-10-11 22:11:09 -04:00
meta Update all libraries and examples to use new set_x API 2022-10-08 20:39:13 -04:00
router Proc-macro hygiene by including cx in view! macro. :-( but necessary... 2022-10-10 20:44:44 -04:00
.gitignore Initial commit 2022-07-31 16:46:14 -04:00
LICENSE Initial commit 2022-07-31 16:40:31 -04:00
README.md Update README.md 2022-10-11 21:42:30 -04:00

Leptos Logo

Leptos

Leptos is a full-stack, isomorphic Rust web framework leveraging fine-grained reactivity to build declarative user interfaces.

What does that mean?

  • Full-stack: Leptos can be used to build apps that run in the browser (client-side rendering), on the server (server-side rendering), or by rendering HTML on the server and then adding interactivity in the browser (hydration)
  • Isomorphic: The same application code and business logic are compiled to run on the client and server, with seamless integration. You can write your server-only logic (database requests, authentication etc.) alongside the client-side components that will consume it, and let Leptos manage the data loading without the need to manually create APIs to consume.
  • Web: Leptos is built on the Web platform and Web standards. Whenever possible, we use Web essentials (like links and forms) and build on top of them rather than trying to replace them.
  • Framework: Leptos provides most of what you need to build a modern web app: a reactive system, templating library, and a router that works on both the server and client side.
  • Fine-grained reactivity: The entire framework is build from reactive primitives. This allows for extremely performant code with minimal overhead: when a reactive signals value changes, it can update a single text node, toggle a single class, or remove an element from the DOM without any other code running. (So, no virtual DOM!)
  • Declarative: Tell Leptos how you want the page to look, and let the framework tell the browser how to do it.

Show me some code!

use leptos::*;

#[component]
pub fn SimpleCounter(cx: Scope, initial_value: i32) -> Element {
    // create a reactive signal with the initial value
    let (value, set_value) = create_signal(cx, inital_value);

    // create event handlers for our buttons
    // note that `value` and `set_value` are `Copy`, so it's super easy to move them into closures
    let clear = move |_| set_value(0);
    let decrement = move |_| set_value.update(|value| *value -= 1);
    let increment = move |_| set_value.update(|value| *value += 1);

    // this JSX is compiled to an HTML template string for performance
    view! {
        cx,
        <div>
            <button on:click=clear>"Clear"</button>
            <button on:click=decrement>"-1"</button>
            <span>"Value: " {move || value().to_string()} "!"</span>
            <button on:click=increment>"+1"</button>
        </div>
    }
}

// Easy to use with Trunk (trunkrs.dev) or with a simple wasm-bindgen setup
pub fn main() {
    mount_to_body(|cx| view! { cx,  <SimpleCounter initial_value=3> })
}

Learn more

Here are some resources for learning more about Leptos: