3 releases
0.0.3 | Feb 18, 2019 |
---|---|
0.0.2 | Oct 6, 2018 |
0.0.1 | Oct 4, 2018 |
#2 in #fairing
11KB
128 lines
Igniter 💨 🔥
Igniter is a Rocket.rs fairing for a better frontend development experience. Igniter let's you launch your frontend dev environment when starting your rocket application.
CLI Support
We currently support NPM and Yarn as CLIs for interaction with your frontend application with hopes to expand to Ember and Vue coming shortly.
Getting Started
Usage
Add the crate as a dependency to your project:
cargo install rocket_igniter
Once the crate is installed you will need to include CliCommand and Engine to configure the desired CLI and start the engine on application start:
extern crate rocket_igniter;
use rocket_igniter::engine::{CliCommand, Engine};
Create a new Engine by passing it the desired CLI enum:
Engine::new(CliCommand::NPM)
Attach the create engine to your application as a fairing:
fn main() {
rocket::ignite()
.mount(
"/",
routes![hello_world],
)
.attach(Engine::new(CliCommand::NPM))
.launch();
}
Start your rocket application and see your development server startup too!
Igniter only runs when in the development environment. If the Rocket environment is configured to be Stage or Production Igniter will get out of your way and happily do nothing!
Configuration
Igniter has default configurations that come out of the box. By default igniter expects your frontend application code to exist under the ./app
directory. If you want your frontend application code to exist elsewhere you can override this by setting the igniter_app_dir
key in your Rocket.toml file under the [development]
heading. For instance if you wanted to place your code under a directory named myApp
the configuration would look like this:
[development]
igniter_app_dir = "./myApp"
On application startup Igniter will run the start
script in your package.json
. Along with the code location this script can be overridden by configuration in Rocket.toml. If your application runs it's development environment by running a different script such as local
instead of start
your settings would look like this:
[development]
igniter_arg = "local"
This will run npm run local
under the hood instead of npm run start
.
If your application has it's code under ./app
and runs the development server with start
then you don't have to touch any configuration!
Issues
As this project is just maintained by me we don't have an offical gitter or discourse. If you run into any issues or have any feature requests please open an issue in the repository! It would be greatly appreciated if you use the issue templates when opening a new issue! Thank you in advance!
Code of Conduct
Anyone who interacts with Diesel in any space, including but not limited to this GitHub repository, must follow our code of conduct.
License
Licensed under either of these:
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
Contributing
Unless you explicitly state otherwise, any contribution you intentionally submit for inclusion in the work, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions.
Dependencies
~10MB
~213K SLoC