oranda

🎁 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.

oranda uses oranda so you can checkout a live example here!

Installation

To install oranda, please visit the oranda website- which is generated by oranda!

Quickstart

# 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

Here's an animated demo:

Configuration

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!

Installers: integrating with cargo-dist

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.