Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MoonZoon/MoonZoon
Rust Fullstack Framework
https://github.com/MoonZoon/MoonZoon
framework fullstack moonzoon rust virtual-actors wasm
Last synced: 3 months ago
JSON representation
Rust Fullstack Framework
- Host: GitHub
- URL: https://github.com/MoonZoon/MoonZoon
- Owner: MoonZoon
- License: mit
- Created: 2020-10-05T17:49:11.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-12T22:17:40.000Z (6 months ago)
- Last Synced: 2024-06-15T21:36:55.439Z (5 months ago)
- Topics: framework, fullstack, moonzoon, rust, virtual-actors, wasm
- Language: Rust
- Homepage:
- Size: 14.8 MB
- Stars: 1,771
- Watchers: 31
- Forks: 80
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-starred - MoonZoon/MoonZoon - Rust Fullstack Framework (rust)
- awesome-rust-list - MoonZoon
- awesome-rust-list - MoonZoon
README
### _"We don't want to lose time and money due to millions of unnecessary technical micro-decisions."_
---
**MoonZoon** is a Rust Fullstack Framework.
- NO Javascript
- NO CSS
- NO HTML
- NO REST
- NO GraphQL
- NO SQL
- NO Analysis Paralysis
- NO Wheel Reinventing
- NO Passwords*
- Rust
- Fast
- Simple
- Scalable
- SEO
- Auth
- MoonZoon CLI
- Easy Deploy
- Offline Support
\* Authentication methods are described in [Backend](docs/backend.md).md
---
# Code example
```rust
use zoon::*;
fn main() {
start_app("app", root);
}
static COUNTER: Lazy> = lazy::default();
fn root() -> impl Element {
Row::new()
.s(Align::center())
.s(Gap::new().x(15))
.item(counter_button("-", -1))
.item_signal(COUNTER.signal())
.item(counter_button("+", 1))
}
fn counter_button(label: &str, step: i32) -> impl Element {
let (hovered, hovered_signal) = Mutable::new_and_signal(false);
Button::new()
.s(Width::exact(45))
.s(RoundedCorners::all_max())
.s(Background::new()
.color_signal(hovered_signal.map_bool(|| color!("#edc8f5"), || color!("#E1A3EE", 0.8))))
.s(Borders::all(
Border::new()
.width(2)
.color(color!("oklch(0.6 0.182 350.53 / .7")),
))
.on_hovered_change(move |is_hovered| hovered.set(is_hovered))
.label(label)
.on_press(move || *COUNTER.lock_mut() += step)
}
```
# Demos
## New Project Template [on Netlify](https://moonzoon-new-project.netlify.app/) | [Template](https://github.com/MoonZoon/MoonZoon/tree/main/crates/mzoon/new_project)
- Used by the command `mzoon new` (see the section [Create & Run project](#create--run-project) below)
## [Production apps in development]
- @TODO Add once the apps are ready to show.
## Chat
- Repo: [examples/chat](examples/chat)
- Related blog post: _"Chat example, MoonZoon Cloud [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-5-chat-example-moonzoon-cloud-5de4) / [MD](docs/articles/dev_news_5.md)]_.
---
# Create & Run project
1. Install the latest stable [Rust](https://www.rust-lang.org/tools/install). (Or upgrade with `rustup update stable`.)
1. Install the web assembly target `rustup target add wasm32-unknown-unknown`
1. `cargo install mzoon --git https://github.com/MoonZoon/MoonZoon --locked`
1. `mzoon new my_counter`
1. `cd my_counter`
1. `mzoon start --open`
---
# Deploy project
## Both Frontend & Backend
I use [Coolify](https://coolify.io/) on [Hetzner](https://www.hetzner.com/) with this `Dockerfile`:
```dockerfile
FROM rust:1
WORKDIR /app
RUN rustup target add wasm32-unknown-unknown
# NOTE: Set `--rev` to the commit you use in your project
RUN --mount=type=cache,target=/usr/local/cargo,from=rust,source=/usr/local/cargo \
cargo install mzoon --git https://github.com/MoonZoon/MoonZoon --rev ccc15d043e78a6656d68a60d46de1f540724e093 --locked
COPY . .
RUN --mount=type=cache,target=/usr/local/cargo,from=rust,source=/usr/local/cargo \
--mount=type=cache,target=target \
/usr/local/cargo/bin/mzoon build -r
RUN --mount=type=cache,target=target \
["cp", "./target/release/backend", "/usr/local/bin/moon_app"]
ENTRYPOINT ["moon_app"]
```
MoonZoon app was successfully deployed to other services like [Heroku](https://www.heroku.com/) ([buildpack](https://github.com/MoonZoon/heroku-buildpack-moonzoon)), [Clever Cloud](https://www.clever-cloud.com/), [CapRover](https://caprover.com/) or [Fly.io](https://fly.io/).
[MoonZoon Cloud](docs/cloud.md) is planned as well.
## Frontend-only
1. `mzoon build --release --frontend-dist netlify`
- Hosting name (`netlify`) is optional. It creates files like `netlify.toml`.
1. _[optional]_ Test it with a dev server like [miniserve](https://crates.io/crates/miniserve):
```bash
cargo install miniserve
miniserve --port 8079 --index index.html --spa frontend_dist
```
1. Drag & drop the `frontend_dist` directory to [Netlify](https://www.netlify.com/).
---
# Examples
- [**Examples**](examples) in the repo [See [development.md](docs/development.md) for instructions how to run them.]
- [Raytracer on MoonZoon](https://github.com/MartinKavik/ray_tracer) [Not maintained)
- [Voting system](https://github.com/MartinKavik/voting-solana-moonzoon) on the [Solana](https://solana.com/) blockchain. [Not maintained)
---
# Blog
- Cure for Web Development [[Medium](https://martinkavik.medium.com/cure-for-web-development-65003afb701f) / [dev.to](https://dev.to/martinkavik/cure-for-web-development-nnn) / [MD](docs/articles/cure_for_web_development.md)]
- Rust on the Frontend and Backend [[Always Bet on Rust](https://blog.abor.dev/p/moonzoon)]
- Interview with Martin about MoonZoon [[console.substack.com](https://console.substack.com/p/console-114)]
### Dev News
1. CLI, Build pipeline, Live-reload, HTTPS [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-1-cli-build-pipeline-live-reload-https-1ba6) / [MD](docs/articles/dev_news_1.md)]
1. Live demo, Zoon, Examples, Architectures [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-2-live-demo-zoon-examples-architectures-2oem) / [MD](docs/articles/dev_news_2.md)]
1. Signals, React-like Hooks, Optimizations [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-3-signals-react-like-hooks-optimizations-39lp) / [MD](docs/articles/dev_news_3.md)]
1. Actix, Async CLI, Error handling, Wasm-pack installer [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-4-actix-async-cli-error-handling-wasm-pack-installer-57cp) / [MD](docs/articles/dev_news_4.md)]
1. **Chat example, MoonZoon Cloud [[dev.to](https://dev.to/martinkavik/moonzoon-dev-news-5-chat-example-moonzoon-cloud-5de4) / [MD](docs/articles/dev_news_5.md)]**
---
# Documentation
### 1. [Philosophy & Non-Goals](docs/philosophy_and_non_goals.md).md
### 2. [Frontend](docs/frontend.md).md
### 3. [Backend](docs/backend.md).md
### 4. [CLI](docs/cli.md).md
### 5. [Cloud](docs/cloud.md).md
### 6. [Development](docs/development.md).md
---
# Size & Speed
[](https://raw.githubusercontent.com/MoonZoon/MoonZoon/main/docs/images/frontend_frameworks_benchmark_screen.png)
- [MartinKavik/js-framework-benchmark](https://github.com/MartinKavik/js-framework-benchmark/tree/framework/moonzoon)
---
# FAQ
1. _"Why another framework? Are you mad??"_
- I want to write products. Reliable products. Quickly. I want to enjoy the development. I don't want to play endlessly with tools, protocols and config files.
1. _"Is it production-ready? / What's the current progress?"_
- The frontend part is almost ready. If you have a custom backend or don't need backend at all then you can start writing your new frontend app right now! And then deploy it wherever you want. I assume there'll be two bigger breaking changes - to improve color system (related [issue](https://github.com/MoonZoon/MoonZoon/issues/98)) and to improve event handlers - but the Rust compiler should make the future migration simple.
- Realtime communication between frontend and backend works but neither virtual actors nor native database adapters have been implemented yet. However, [Actix](https://actix.rs/) API has been exposed to overcome these current limitations so you can treat the MoonZoon backend API as Actix with realtime messaging. I've successfully integrated Postgres (through [SeaORM](https://www.sea-ql.org/SeaORM/)) into a MoonZoon app developed for my client and I plan to integrate [BonsaiDb](https://bonsaidb.io/) to my another production app. Bonsai could be integrated as a scalable database and file storage into MoonZoon when I'll find it a suitable choice.
- Subscribe to `#news` channel on our [Discord server](https://discord.gg/eGduTxK2Es) to find out when MoonZoon is ready for your project. Or just let us know what blocks you from starting to develop with MZ.
1. _"Who is developing it?"_
- Martin Kavík (a former [Seed](https://seed-rs.org/) maintainer, Rust freelance developer) with the help of the awesome community.
- [An interview with Martin Kavík](https://blog.abor.dev/p/moonzoon)
1. _"Could I help somehow? / Where can I find more information?_"
- Join our [Discord chat](https://discord.gg/eGduTxK2Es) and don't hesitate to ask any questions or present your ideas.
- Create a pull-request if you want to fix typos, dead links, weird Czech-English sentences, etc.
- If you think MoonZoon will be useful for your project, I want to know that! (Use [chat](https://discord.gg/eGduTxK2Es) or [[email protected]](mailto:[email protected])).
- Don't hesitate to tell your friends about MoonZoon and feel free to share the link ([http://moonzoon.rs](http://moonzoon.rs)) on social platforms / forums / blogs / newsletters.
1. _"Why Rust?"_
- It's the best language.
Longer explanation
I've written commercial or hobby projects in multiple languages (Js, CoffeeScript, TS, Elm, Elixir, PHP, C, C++, C#, Go, ..). However I want to write only in Rust.
Rust is hard to learn even for experienced developers because they have to unlearn many things and adapt thought process to Rust concepts and best practices. However, once you stop fighting the compiler, Rust takes your hand and push you to correct and efficient solutions.
I had similar feeling when I was learning to drive a car - it seems to be pretty difficult/strange from the start but once you get used to it, you know that each control / button / pedal has it's specific place and purpose for a good reason. And it makes even more sense when you learn low-level stuff - e.g. how the transmission and a clutch work.
Steep learning curve also brings some benefits:
- It means that Rust doesn't hide real complexity behind too simple models.
- It's almost impossible for complete beginners to publish incomplete/buggy libraries.
_
Rust is designed so well that I feel nervous while I'm writing in other languages - I have to do compiler's work again in my head and think about weird things like typos in code, `null`s, `undefined`s, memory leaks, accidental mutations, how to write fast code without mutability, etc. It generates significant cognitive load so I can't focus so much on business logic and other important stuff.
I don't believe you should use the most suitable language for a specific domain or problem at all costs. I think consistency among your / company projects, productivity and simplicity should have the highest priority. And Rust is a very universal language so I think it's a good choice for almost all cases.
There are also things that should be improved (and are improving):
1. Compilation is still slow, but it's not so frustrating now.
1. IDE support still isn't very good because of Rust complex types and macros but thanks to [Rust Analyzer](https://rust-analyzer.github.io/) it's getting better every day.
1. `target` folder (it's something like `node_modules`) can be pretty big.
1. It's a bit difficult to combine sync and async world in some cases and choose the best async runtime and error handling libraries. Also async drop would be nice.
1. `#[derive(xx)]` and `cargo install` may have a bit surprising behavior.
1. It may be a bit difficult to pick compatible dependencies.
So there is still room for improvements but even now I'm the most productive in Rust.
---
Thank you for reading! We are waiting for you on [Discord](https://discord.gg/eGduTxK2Es).