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:

1. Runs cargo build
2. Gathers artifacts produced during the build and by vertigo / vertigo-macro libraries:
   • index.html
   • wasm_run.js
   • your_project.wasm
   • included static files
3. Optimizes your .wasm file using wasm-opt
4. Adds hashes to filenames[^hashes] (to bypass browser's cache)
5. Places everything in the build dictionary

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

[^hashes]: Except hashes for included static files - these are computed by vertigo-macro library

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_blog

And 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