Expand description
§vertigo-cli
A packaging tool and server for vertigo library
This package provides vertigo binary that allows to create, build, serve and watch vertigo-based projects.
Packaging steps performed during build command:
- Runs cargo build
- Gathers artifacts produced during the build and by
vertigo/vertigo-macrolibraries:index.htmlwasm_run.jsyour_project.wasm- included static files
- Optimizes your .wasm file using
wasm-opt - Adds hashes to filenames1 (to bypass browser’s cache)
- Places everything in the
builddictionary
§Installation
cargo install --force vertigo-cli§Example usage (pure frontend)
§Generate new project
vertigo new my_blog§Build the project
cd my_blog
vertigo build§Serve project
vertigo serve --host 0.0.0.0 --port 8000§Watch project
vertigo watch§Mounting in actix (fullstack)
Vertigo-cli provides a simple way to mount vertigo app in actix-web. To see an example generate a fullstack project:
vertigo new --template fullstack my_blogAnd run the backend (builds frontend automatically as a dependency):
cd my_blog
cargo make run-be§Error codes returned from vertigo-cli commands
1 Cant Open Workspace
2 Cant Parse Workspace
3 Cant Find Cdylib Member
4 Package Name Not Found
5 Build Failed
6 Build Prerequisites Failed
7 Watcher Error
8 Cant Add Watch Dir
9 Other Process Already Running
10 Cant Read Wasm Run From Statics
11 Cant Read Static File
12 Cant Write Or Remove File
13 Cant Spawn Child Process
14 Couldn’t Wait For Child Process
15 …removed…
16 Watch Pipe Broken
17 New Project Dir Not Empty
18 New Project Cant Create Dir
19 New Project Cant Unpack Stub
20 New Project Can Create Cargo Toml
21 New Project Can Write To Cargo Toml
22 Serve Cant Find Http Base Path
23 Serve Cant Read Index File
24 Serve Cant Open Port
25 Serve Wasm Read Failed
26 Serve Wasm Compile Failed
27 Serve Wasm Instance Failed
Except hashes for included static files - these are computed by vertigo-macro library ↩
Re-exports§
pub use build::BuildOpts;pub use new::NewOpts;pub use serve::ServeOpts;pub use watch::WatchOpts;pub use serve::vertigo_install;