# oranda

🎁 generate beautiful landing pages for your projects

crates.io CI release web

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][`oranda` website]! ## Installation To install `oranda`, please visit the [`oranda` website]- which is generated by `oranda`! [`oranda` website]: https://axodotdev.github.io/oranda

Quickstart

```sh

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

oranda dev ```

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:

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.