🎁 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 so you can checkout a live example here!
oranda, please visit the
oranda website- which is generated by
# build your site > oranda build # build your site and start a server that rebuilds on file changes > oranda dev
Here's an animated demo:
First of all:
oranda is designed to work without a configuration file. For a lot of projects,
you can likely just run
oranda build and get a site that contains a couple of things that
oranda was automatically able to glean about your project. That being said, it also supports
a configuration file that allows you to tweak many things about oranda's behaviour.
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
oranda has first-class integration with
cargo-dist, a tool that builds
distributable artifacts for your Rust applications. If you have
configured in your project correctly,
oranda will be able to automatically
tell. Benefits of integrating with
- Installer scripts:
cargo-distcan generate one-line installer scripts, which
orandawill display in your generated page
- Guaranteed platform support:
orandatries to support as many platforms as it can, but if you build something with
cargo-dist, we guarantee it'll show up correctly
Feel free to open a new issue or pull request if you notice something off or have a new feature request! We sometimes tag issues with good first issue for issues that we think would make a good learning experience for new contributors.
For local development on oranda, we also have a special docs page with some tips.