Skip to content

idaibin/rustzen-admin

Repository files navigation

📚 rustzen-admin Documentation Center


License: MIT Language Status


简体中文

A modern full-stack admin system template built with Rust (Axum) and React (Vite + Ant Design). Designed for performance, simplicity, and scalability.

🎯 Project Goals

This project aims to become a modern admin backend template in the Rust ecosystem, providing:

  1. Out-of-the-box: Complete RBAC permission system and basic functionality
  2. Code Quality: Good code structure and security
  3. Easy to Extend: Clear modular architecture
  4. Best Practices: Demonstrates Rust + React full-stack development patterns

⚙️ Tech Stack

Layer Technology
Backend Rust, Axum, SQLx, PostgreSQL, Tracing
Frontend React, TypeScript, Vite, Ant Design, TailwindCSS
Auth JWT (JSON Web Tokens)
Tooling just, pnpm

📦 Directory Structure

rustzen-admin/
├── src/              # Rust (Axum) API service source code
├── web/              # React (Vite) admin frontend
├── migrations/       # Database migration files
├── docs/             # Project documentation
├── Cargo.toml        # Rust dependencies configuration
├── justfile          # Project command runner
└── README.md

🛠️ Quick Start

Prerequisites

Installation & Setup

  1. Clone the repository:

    git clone https://github.com/idaibin/rustzen-admin.git
    cd rustzen-admin
  2. Set up environment variables:

    cp .env.example .env
    # Edit .env file with database connection information
  3. Install dependencies:

    # Install just and Rust dependencies
    cargo install just
    cargo install cargo-watch
    
    # Install frontend dependencies
    cd web && pnpm install && cd ..
  4. Start the project:

    just dev

    The application will be available at http://localhost:5173.


📖 Project Documentation


📄 Open Source License

This project is licensed under the MIT License. See LICENSE.md for details.


Developed by [idaibin], committed to building deployable, maintainable, and scalable Rust full-stack system engineering templates 🦀