Skip to content

Latest commit

 

History

History
79 lines (58 loc) · 2.17 KB

README.md

File metadata and controls

79 lines (58 loc) · 2.17 KB
Leptos Logo

Minesweeper-io

Multiplayer Minesweeper website

Create database

Create sqlite database in workspace root

Setup .env

Copy .env.example in workspace root into .env and fill in

Running the project

cargo leptos watch

Installing Additional Tools

By default, cargo-leptos uses nightly Rust, cargo-generate, and sass. If you run into any trouble, you may need to install one or more of these tools.

  1. rustup toolchain install nightly --allow-downgrade - make sure you have Rust nightly
  2. rustup target add wasm32-unknown-unknown - add the ability to compile Rust to WebAssembly
  3. cargo install cargo-generate - install cargo-generate binary (should be installed automatically in future)
  4. npm install -g sass - install dart-sass (should be optional in future

Compiling for Release

cargo leptos build --release

Will generate your server binary in target/server/release and your site package in target/site

Testing Your Project

cargo leptos end-to-end
cargo leptos end-to-end --release

Cargo-leptos uses Playwright as the end-to-end test tool.
Tests are located in end2end/tests directory.

Executing a Server on a Remote Machine Without the Toolchain

After running a cargo leptos build --release the minimum files needed are:

  1. The server binary located in target/server/release
  2. The site directory and all files within located in target/site

Copy these files to your remote server. The directory structure should be:

minesweeper-web
site/

Set the following environment variables (updating for your project as needed):

LEPTOS_OUTPUT_NAME="minesweeper-web"
LEPTOS_SITE_ROOT="site"
LEPTOS_SITE_PKG_DIR="pkg"
LEPTOS_SITE_ADDR="127.0.0.1:3000"
LEPTOS_RELOAD_PORT="3001"

Finally, run the server binary.

sqlx

cargo install sqlx-cli
sqlx migrate build-script
sqlx db create