Askama + Axum + HTMX Starter Template

A production-ready template for building websites with Askama, Axum, and HTMX.

Features

• Askama - Type-safe, compiled Jinja-like templates
• Axum - Modern, fast Rust web framework
• HTMX - Dynamic HTML without JavaScript frameworks
• TLS/HTTPS - Built-in support with axum-server and Let's Encrypt certs
• Forgejo CI - CI workflows for clippy, tests, formatting
• Zed Editor config - Formatter integrations for TOML, HTML, CSS, YAML, JSON, Docker

Quick Start with cargo-generate

cargo generate --git ssh://git@git.ohcooltools.dev/Ohcool-Media/askama-template.git

This will create a new project from the template. Follow the prompts to name your project.

Manual Setup

1. Clone this repository
2. Rename the project in Cargo.toml

Development

Run the server (HTTPS on 2040):

cargo run

Project Structure

.
├── Cargo.toml
├── cargo-generate.toml       # cargo-generate config
├── rustfmt.toml              # Rust formatting config
├── .prettierrc               # Prettier config for templates
├── .gitignore
├── .forgejo/
│   └── workflows/            # CI workflows
├── .zed/
│   └── settings.json         # Zed editor config
├── scripts/                  # Formatting/utility scripts
├── public/
│   └── style.css             # Your stylesheets
├── src/
│   └── main.rs               # Server entry point
└── templates/
    ├── base.html             # Base layout
    ├── header.html           # Site header (included)
    ├── footer.html           # Site footer (included)
    ├── index.html            # Home page
    └── about.html            # About page

Deploying

1. Run the binary or use Docker

Customization

• Add templates in templates/
• Add Askama template structs in src/main.rs
• Add routes with Router::new().route(...)
• Add static assets in public/

License

MIT