Hyperide
A contraction of hypermedia oxyhydroxide.
This library provides utilities to help develop within the hyperide stack.
The Hyperide Stack Contains
- A backend provider, your choice of axum (server) or vercel (serverless)
- A database provider, your choice of planetscale (mysql) or turso (sqlite)
- HTML in Rust (through the
hyperide!
macro) - Style in HTML (tailwind)
- Hypermedia requests in HTML (htmx)
- Scripted interactivity in HTML (hyperscript)
Through combining these technologies, you can develop fullstack hypermedia applications entirely from within Rust.
Backend
The stack recommends using Axum optionally and Vercel for your backend.
Axum
You can learn how to use Axum by looking at it's documentation. Use hyperide!
to build your HTML responses.
async : )
Vercel
To use vercel, you will need to create and modify the following files:
/vercel.json
/.vercelignore
target/
/Cargo.toml
# add this section
[[]]
= "main"
= "api/main.rs"
/api/main.rs
use ;
use Error;
async
Database
The stack recommends choosing between Planetscale and Turso for your database backend, as both can run in serverless environments. Alternatively, use SQLx and your favourite database.
HTML In Rust
Macros for generating HTML inside Rust. Think of it a bit like leptos, yew, or
any other crate that provides HTML in Rust, but without 99% of the
functionality. You write HTML like syntax, and you get a String
back.
hyperide!
<!-- "wildcard close tag ⬆️" -->
Foo: bar
Hello, world!
This is in a closed paragraph.
Style In HTML
It is recommended that you set up tailwind as part
of your build step. You will need the tailwind cli installed. The script will
attempt to use tailwind
as the binary by default, but you can overwrite this
with the TAILWIND_BIN
environment variable.
/tailwind.config.js
module.exports = ;
/tailwind.in.css
@ @ @
/build.rs
use Path;
Use the include_tailwind!
macro in the <head>
of your responses to include
the stylesheet generated by tailwind.
Hypermedia Requests In HTML
I recommend you read the Hypermedia Systems book
and htmx documentation. Use hyperide::htmx::include_htmx!
to add it into the <head>
of your responses.
Scripted interactivity in HTML (hyperscript)
To add simple inline scripting support using
hyperscript. Use
hyperide::hyperscript::include_hyperscript!
to add it into the <head>
of
your responses.
VSCode Syntax Highlighting
This is what you want:
https://marketplace.visualstudio.com/items?itemName=brvnonascimento.code-html-macro-server