Seed is a front-end Rust framework for creating fast and reliable web apps with an elm-like architecture.
stable Rust, no nightly required!The examples provided in this repository are a good place to get started. They also act as an integration testing suite we run before every commit to ensure there are no unintended breaking changes to the user space. Because of Rust's compile-time checking, testing is that much more robust and changes can be pushed confidently.
Run examples with cargo make start example_name from the Seed repository root. Here's our counter example:
```rust use seed::{prelude::*, *};
// init describes what should happen when your app started.
fn init(_: Url, _: &mut impl Orders
// Model describes our app state.
type Model = i32;
// Msg describes the different events you can modify state with.
enum Msg {
Increment,
}
// update describes how to handle each Msg.
fn update(msg: Msg, model: &mut Model, _: &mut impl Orders
// view describes what to display.
fn view(model: &Model) -> Node
pub fn start() {
// Mount the app to the element with the id "app".
App::start("app", init, update, view);
}
```
If you are proficient in a front-end framework, creating a standalone web app is painless. You'll notice minimal configuration:
├── Cargo.toml
├── Makefile.toml
├── index.html
└── src
└── lib.rs
We currently have two template repositories: - Quickstart - Webpack quickstart
You may prefer writing in Rust and appreciate its benefits, including: - Rust safety. - Rust compile-time error, type, and immutability checking. - Rust built-in testing. - Rust speed. - Cleaner code and less runtime errors. - Cargo packages. - Potential pipeline/stack language consistency.
Our main focus is on developer experience, the benefits of which are currently: - Seed has a batteries-included approach, meaning less boilerplate and dependencies. - Macro syntax removes the need for transpiling and integrates naturally and flexibly with the language. This also means all the pains of embedded HTML are avoided; linting, commenting, etc. all work out of the box. - Built in elm-like architecture, no need for another state manager. - Perhaps you find JS frameworks and tools difficult to set up. - Very active development.
See more on our about page.
See CONTRIBUTING.md.