Skip to content

Bodyhc/BlazeUI

Repository files navigation

πŸ”₯ BlazeUI

A beautiful, modern, and accessible component library for React built with Radix UI and Tailwind CSS.

BlazeUI React TypeScript Tailwind CSS

✨ Features

  • 🎨 30+ Beautiful Components - Ready-to-use components built with Radix UI primitives
  • πŸŒ“ Dark Mode Support - Built-in dark/light theme toggle
  • πŸ“± Fully Responsive - All components work seamlessly across all screen sizes
  • β™Ώ Accessible - Built on Radix UI primitives following WAI-ARIA patterns
  • 🎭 Customizable - Easy to customize with Tailwind CSS
  • ⚑ Performance Optimized - Lightweight and fast
  • 🎯 TypeScript - Full TypeScript support for better developer experience
  • πŸš€ Copy & Paste - Copy component code directly and use in your project

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn or pnpm

Installation

1. NPM (Recommended)

Install the package:

npm install @bodyhc/blazeui

Usage:

import { Button } from "@bodyhc/blazeui"

Important

Use @bodyhc/blazeui (no hyphen). Import directly from the root; do not use subpaths like /components/ui/button.

2. Manual

For manual installation (copy/paste), see our Installation Guide.

Framework Guides

Peer Dependencies

npm install framer-motion lucide-react clsx tailwind-merge tailwindcss-animate

πŸ“¦ Available Components

Basic Components

  • Button
  • Input
  • Textarea
  • Label
  • Badge
  • Card
  • Alert
  • Avatar
  • Skeleton
  • Separator

Form Components

  • Checkbox
  • Radio Group
  • Switch
  • Select
  • Slider
  • Progress

Overlay Components

  • Dialog
  • Sheet
  • Popover
  • Tooltip
  • Hover Card
  • Dropdown Menu

Layout Components

  • Tabs
  • Accordion
  • Scroll Area
  • Command
  • Timeline

Special Effects

  • 3D Card
  • Magic Card
  • Pixel Card
  • Glitch Text
  • Sparkles
  • Magnet Button
  • Animated Number

πŸ› οΈ Tech Stack

  • React 18.2 - UI library
  • TypeScript - Type safety
  • Vite - Build tool
  • Tailwind CSS - Styling
  • Radix UI - Accessible primitives
  • Framer Motion - Animations
  • React Router - Routing
  • Lucide React - Icons

πŸ“‚ Project Structure

blazeui/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ ui/           # UI components
β”‚   β”‚   β”œβ”€β”€ layout/       # Layout components
β”‚   β”‚   └── marketing/    # Marketing components
β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ docs/         # Documentation pages
β”‚   β”‚   └── ...           # Other pages
β”‚   β”œβ”€β”€ contexts/         # React contexts
β”‚   β”œβ”€β”€ lib/              # Utility functions
β”‚   β”œβ”€β”€ App.tsx           # Main app component
β”‚   └── main.tsx          # Entry point
β”œβ”€β”€ public/               # Static assets
└── dist/                 # Build output

πŸ“– Usage

Using Components

  1. Browse components at /components or read docs at /docs
  2. Copy the component code
  3. Paste into your project
  4. Customize as needed with Tailwind CSS

Example

import { Button } from "@bodyhc/blazeui";

function App() {
  return (
    <Button variant="default" size="lg">
      Click me
    </Button>
  );
}

Theme Setup

BlazeUI uses a theme provider for dark/light mode support. Wrap your app with the ThemeProvider:

import { ThemeProvider } from "@bodyhc/blazeui";

function App({ children }) {
  return (
    <ThemeProvider defaultTheme="dark" storageKey="blaze-ui-theme">
      {children}
    </ThemeProvider>
  );
}

🎨 Theming

BlazeUI supports customizable themes through Tailwind CSS. You can customize colors, spacing, and more in your tailwind.config.js:

module.exports = {
  theme: {
    extend: {
      colors: {
        // Your custom colors
      },
    },
  },
}

πŸ“ Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

πŸ“„ License

This project is open source and available under the MIT License.

πŸ”— Links

πŸ’‘ Acknowledgments


Made with ❀️ by the BlazeUI team

About

A beautiful, modern, and accessible component library for React built with Radix UI and Tailwind CSS.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors