🎁 generate beautiful landing pages for your projects

oranda is an opinionated static-site generator that is designed for developers who are publishing projects and would like a website but don't want to build one from scratch.

# build your site
> oranda build

# start a server to checkout a local version of your built site in a browser
> oranda serve

# build your site and start a server that rebuilds on file changes
> oranda dev

If you'd like to configure oranda, place an oranda.json file in the root of your project and fill it with the configuration you'd like. Check out the docs to learn more about your configuration options!

oranda is built to work alongside cargo-dist, which is a tool that builds distributable artifacts for your Rust applications. To tell oranda you are using cargo-dist you can add this to your oranda.json:

"artifacts": {
    "cargo_dist": true
}

This will link oranda and cargo-dist such that oranda can display your installers and downloadable artifacts on your page.