Cargo is rust's tool for creating new propjects, downloading dependencies, compile or run projects among others.

Rin provides an extension to Cargo to create new projects that already include the necesary dependencies and an skeleton of an empty application that opens a blank window. It also allows to run projects in the different supported platforms easily, including the browser.

To install rin's cargo extensions:

cargo install cargo-rin

To update to a new version later you can run:

cargo install --force cargo-rin

You can now create new rin projects by running from a console:

cargo rin new project_path

Which will create a default empty project.

From there on you can use plain cargo to build and run your application but cargo rin also gives you more options specific to rin projects. Run cargo rin --help for more options.

Now you can install any IDE with support for Rust (usually through extensions). Rin has been mostly tested with visual code along with the rust-analyzer and Better TOML extensions.

Other IDEs with Rust support should work as well or even just using any text editor and compiling from the command line using cargo build and cargo run.

rin is free / open source software licensed as Mozilla public license 2.0. The MPL license is a weak copyleft license, meaning that rin itself and any modfications to it have to be distributed under the MPL while larger software based on it can be distributed under other licenses.

The MPL2 FAQ explains the license more broadly in a non legal language.

While the MPL2 allows commercial use we urge you to buy a commercial license for such cases.

By expressly choosing a free / open source license like the MPL2 and not a non-commercial only one we want to ensure that users have all the rights that free and open source software provides them and that the project has continuity if the main maintainers decided to discontinue it.

This will ensure that projects done using rin can be easily maintained and restored in the future.

Meanwhile our code of conduct makes express mention of fair economic use of rin: if you are making a profit from using it you should buy a commercial license or contribute financially through our partners program or individual donations.

We hope this model will help making rin's development more sustainable and it's community of contributors more diverse by means of being able to pay the people who develop it and not only rely on voluntary contributions.

In the near future we plan to add a way for people using rin to offer their own addons under similar conditions.