tapegram / rust-htmx-axum-template

A template repository for making rust webapps with htmx and axum

WallChart for Y'all

Installing/Running

Setup our prepush hook (to protect main)

git config core.hooksPath .git-hooks

cargo run

You can also leverage cargo-watch

cargo install cargo-watch

# Then you can do the following
cargo watch -x run

Code generation

We are experimenting with code generation tools (using plopjs). run ./generate.sh to enter the code generation dialogue.

MiroBoard

This board contains our stories, kanban board and all other supplemental material. https://miro.com/app/board/uXjVNffAsKM=/?share_link_id=874499028180

Architecture & Tech Stack

Frontend Client

This application required bun be installed. If you get an error regarding bun not being found, please install bun.

The web-client crate is responsible for building our client-side assets. Assets for the client are reusable UI components, bespoke web controls (to extend our hypermedia client - the browser). This crate leverage bun as our bundler for our TypeScript modules and TailwindCss (coming soon) for css. See the web-client README.md for more.

The web-htmx crate serves as "the backend for the frontend" using HTMX as the means to deliver a more rich UI w/out relying on custom JavaScript.