Skip to content

any-tdf/raatdf

Repository files navigation

Project Overview

RAATDF is an efficient, elegant, and lightweight enterprise-grade admin template built with the latest technology stack, providing an out-of-the-box solution.

Quick Links

📺 Live Demo | 📖 Documentation | 🐙 GitHub Repository

Core Technology Stack

  • Build Tool: Vite v8 (Beta) - Lightning-fast development experience
  • Frontend Framework: React v19 - Latest version with React Compiler support
  • Type System: TypeScript v5 - Strict type checking
  • UI Framework: Ant Design v6 - Enterprise-grade UI component library
  • Styling: Tailwind CSS v4 - Atomic CSS framework
  • State Management: Zustand v5 - Lightweight state management
  • Routing: React Router v7 - Latest routing solution
  • Code Quality: Biome - Unified lint and format tool

Features

Layout System

  • Multiple Layouts: Sidebar, top bar, and mixed layouts
  • Responsive Design: Perfect adaptation for all screen sizes
  • Floating UI: Elegant floating UI style
  • Immersive Mode: Full-screen experience focused on content
  • Sidebar Toolbar: Place toolbar at the bottom of sidebar (vertical layout only)

Theme System

  • Light/Dark Themes: Light, dark, and system-follow modes
  • Theme Colors: 10+ preset colors + custom colors
  • Dynamic Switching: Seamless theme switching via CSS variables
  • Border Radius: 9 radius sizes available (0-24px)

Interaction Enhancement

  • Multi-Tab: Up to 16 tabs, auto-closes oldest tab
  • Page Cache: Preserves page state for better UX
  • Tab Styles: Default, button, simple, and stacked styles
  • Transitions: Slide, fade, zoom, and more animations
  • Compact Mode: Suitable for data-intensive scenarios

Display Options

  • Page Width: Adaptive or fixed width
  • Card Container: Card-style content display
  • Refresh Button: Quick page refresh
  • Collapse Button: Toggle sidebar expand/collapse
  • Header Buttons: Notification center, chat window, and more

Internationalization

  • Multi-Language: Built-in Chinese and English, easily extensible
  • Full Translation: System settings, menus, tooltips, etc.
  • Dynamic Switching: Switch languages without page refresh

Quick Start

Requirements

  • Node.js >= 18.0.0
  • Bun >= 1.0.0 (recommended) or npm/yarn/pnpm

Installation

# Clone the repository
git clone git@github.com:any-tdf/raatdf.git

# Enter project directory
cd raatdf

# Install dependencies
bun install

# Start development server
bun dev

# Build for production
bun run build

# Preview production build
bun run preview

Common Commands

# Code checking and formatting
bun run check        # Run Biome checks
bun run check:fix    # Auto-fix code issues
bun run lint         # Lint only
bun run lint:fix     # Auto-fix lint issues
bun run format       # Check formatting
bun run format:fix   # Auto-format code

Browser Compatibility

Browser Version
Chrome >= 90
Edge >= 90
Firefox >= 88
Safari >= 14

Recommended: Use the latest version of modern browsers for the best experience.

Contributing

We welcome all forms of contributions, whether it's new features, bug fixes, or documentation improvements.

How to Contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'feat: add some amazing feature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Commit Convention

Please follow Conventional Commits:

  • feat: New feature
  • fix: Bug fix
  • docs: Documentation update
  • style: Code style changes
  • refactor: Code refactoring
  • chore: Build/tool related

Feedback & Communication

Recommended

Community

Community links coming soon.

Contributors

Thanks to all developers who have contributed to this project!

Contributors

Sponsors

If this project helps you, please consider sponsoring to support our continued development.

License

This project is licensed under MIT.

Star History

Star History Chart

Made with ❤️ by any-tdf

About

RAATDF is an efficient, elegant, and lightweight enterprise-grade admin template built with the latest technology stack, providing an out-of-the-box solution.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors