Skip to content

Latest commit

 

History

History
94 lines (79 loc) · 2.54 KB

development.md

File metadata and controls

94 lines (79 loc) · 2.54 KB

MoonZoon Development

WARNING: MoonZoon is in the phase of early development and a CI pipeline / linters haven't been configured yet.

1. Required tools

  • Rust

    rustup update stable
rustc -V # rustc 1.58.1 (db9d1b20b 2022-01-20)

  • cargo-make

    cargo install cargo-make --no-default-features
makers -V # makers 0.35.8
    • Note: cargo-make is needed only for MoonZoon development and running its examples, you don't need it for your apps.

2. VS Code settings

  • Install Rust Analyzer
  • The current .vscode/settings.json:
    • (Most examples are commented out to reduce the amount of operating memory consumed by RA.)
{
    "rust-analyzer.linkedProjects": [
        // rust-analyzer ignores `main.rs` when `linkedProjects` are set
        "crates/mzoon/Cargo.toml",
        // examples are ignored because they have own workspaces
        // "examples/canvas/Cargo.toml",
        // "examples/chat/Cargo.toml",
        "examples/counter/Cargo.toml",
        // "examples/counters/Cargo.toml",
        // "examples/custom_http_client/Cargo.toml",
        // "examples/js-framework-benchmark/keyed/Cargo.toml",
        // "examples/markup/Cargo.toml",
        // "examples/pages/Cargo.toml",
        // "examples/paragraph/Cargo.toml",
        // "examples/resize_drag/Cargo.toml",
        // "examples/start_with_app/Cargo.toml",
        // "examples/svg/Cargo.toml",
        // "examples/time_tracker/Cargo.toml",
        // "examples/timer/Cargo.toml",
        // "examples/todomvc/Cargo.toml",
        // "examples/viewport/Cargo.toml",
    ],
    "rust-analyzer.diagnostics.disabled": [
        "missing-unsafe",
        "add-reference-here",
    ],
    "rust-analyzer.procMacro.enable": true,
    "rust-analyzer.cargo.allFeatures": true,
    "rust-analyzer.completion.autoimport.enable": false,
    // "rust-analyzer.updates.channel": "nightly"
}

3. Start example

  • Runnable examples (the list is continuously updated):
    • canvas
    • chat
    • counter
    • counters
    • custom_http_client
    • js-framework-benchmark/keyed
    • markup
    • pages
    • paragraph
    • resize_drag
    • svg
    • start_with_app
    • time_tracker
    • timer
    • todomvc
    • viewport
cd examples
cd chat # or another example
makers mzoon start -o # add -r for the release mode

5. Have fun!

--

Dev note: You can kill a zombie server on Linux with kill -9 $(lsof -t -i:8080)