RustKit Web

🚀 RustKit Web is a modern Rust-based fullstack web framework inspired by SvelteKit and Next.js, with built-in support for:

• 🦀 Axum (HTTP routing)
• 🎨 TailwindCSS
• 📦 Askama (HTML templates with Rust)
• 📁 File-based routing
• ✅ SSR-ready architecture
• ⚙️ Simple CLI (via cargo rustkit-web)

🌍 Why RustKit?

In a web world dominated by JavaScript and its ever-evolving toolchains, RustKit Web brings clarity, performance, and safety to fullstack development. Whether you're building a personal site or a high-performance app, RustKit provides:

• 🦀 The power and speed of Rust
• 🧩 The simplicity of file-based routing
• 🔐 Memory safety and reliability
• 🧰 A familiar DX inspired by SvelteKit/Next.js — but with Rust!

No more juggling 10 config files. No more complex bundlers. Just plain Rust, clean HTML templates, and a CLI that just works.

✨ Features

• 🗂️ File-based routing like Next.js
• 🧠 Askama templates (like Jinja2/Laravel Blade)
• 🎨 Built-in TailwindCSS setup
• 💡 Developer-friendly CLI (cargo rustkit-web)
• 🔧 Dev + Prod modes with build and start commands
• 🔁 Nested routes support

🛠️ Getting Started

1. Install the CLI

cargo install cargo-rustkit-web

2. Create a New Project

cargo rustkit-web new myapp
cd myapp

3. Run Dev Mode

cargo rustkit-web dev

➕ Add Routes

Create files like this:

src/routes/about/page.rs        → GET /about  
src/routes/blog/post/page.rs   → GET /blog/post

Example page.rs (Raw HTML)

use axum::response::Html;

pub async fn handler() -> Html<&'static str> {
    Html("<h1>Hello from this route!</h1>")
}

Example page.rs (Askama Template)

use askama::Template;
use axum::response::Html;

#[derive(Template)]
#[template(path = "about/page.html")]
struct AboutPage;

pub async fn handler() -> Html<String> {
    Html(AboutPage.render().unwrap())
}

🧱 Build for Production

cargo rustkit-web build

This creates:

/build
├── app            # compiled binary
├── public         # static files

🚀 Run Production Server

cargo rustkit-web start

This serves the production binary from /build.

📁 Folder Structure

myapp/
├── src/
│   ├── routes/
│   │   ├── index/page.rs
│   │   └── hello/page.rs
│   └── main.rs
├── templates/
│   ├── index/page.html
│   └── hello/page.html
├── public/
│   └── styles.css
├── input.css
├── tailwind.config.js
├── Cargo.toml

🧪 CLI Commands

cargo rustkit-web new <name>
cargo rustkit-web dev
cargo rustkit-web build
cargo rustkit-web start

🛣 Roadmap

• File + Nested routing
• Askama templates
• Tailwind integration
• CLI support
• Production build/start
• Middleware system
• HTMX/Vite plugin
• Component-based template rendering

📜 License

MIT © Mukul