acidui-core
v1.0.1
Published
> **TACTICAL_STATUS: READY_FOR_DEPLOYMENT** > > ACIDUI is a high-performance, industrial-grade React component library built for speed, aesthetics, and tactical precision. Designed with a "premium-acid" aesthetic, it leverages Framer Motion for smooth, m
Downloads
224
Readme
ACIDUI_CORE // INDUSTRIAL_UI_SYSTEM
TACTICAL_STATUS: READY_FOR_DEPLOYMENT
ACIDUI is a high-performance, industrial-grade React component library built for speed, aesthetics, and tactical precision. Designed with a "premium-acid" aesthetic, it leverages Framer Motion for smooth, micro-animated interactions and Vite for lightning-fast development.
⚡ QUICK_START
1. Installation
Deploy the system into your repository:
npm install acidui-core2. Peer Dependencies
Ensure the vital subsystems are installed:
npm install framer-motion lucide-react canvas-confetti clsx3. Usage
Import industrial units into your React application:
import { AcidButton, AcidMagicCard, AcidBentoGrid } from 'acidui-core';
import 'acidui-core/dist/style.css'; // Ensure styling is injected
export const App = () => (
<AcidMagicCard>
<h2>SYSTEM_BOOT_COMPLETE</h2>
<AcidButton variant="industrial">INIT_DIAGNOSTICS</AcidButton>
</AcidMagicCard>
);🛠️ CORE_COMPONENTS
ACIDUI includes over 170+ hand-crafted components. Notable units include:
- [TACTICAL] Magic & Glass:
AcidMagicCard,AcidGlassFolder,AcidAuroraText. - [STRUCTURE] Layouts:
AcidBentoGrid,AcidGridBox,AcidMasonry. - [MOTION] Animations:
AcidTypingText,AcidMarquee,AcidScrollReveal. - [UTILITY] Controls:
AcidCommand,AcidDock,AcidTerminalCard. - [VISUAL] Special Effects:
AcidElectroBorder,AcidBorderBeam,AcidConfettiButton.
📟 COMMAND_LINE_INTERFACE
Initialize and manage your UI subsystems via the integrated CLI.
# Initialize AcidUI config
npx acidui-core init
# List available modules
npx acidui-core list
# Add a specific component (Experimental)
npx acidui-core add AcidButton⚡ CATEGORY_BASED_INSTALLATION (NEW)
Install all components from a specific category at once with Intelligent Dependency Management.
🛠️ POWERFUL_FEATURE
This tactical feature allows you to initialize entire groups of related components in one command, perfect for rapid orchestration of complex dashboard or landing page clusters.
📟 COMMAND_SYNTAX
# Full command
npx acidui-core add --category <category-name>
# Short form
npx acidui-core add -c basic📋 AVAILABLE_CATEGORIES
| Category | Description | Dependencies |
| :--- | :--- | :--- |
| basic | Foundational UI units | None |
| ui | Standard interactive elements | lucide-react |
| layout | Structural containers | lucide-react |
| navigation | Routing & Menu units | framer-motion |
| background | Visual effects & shaders | framer-motion |
| button | Animated high-impact triggers | canvas-confetti |
| charts | Data visualization units | recharts |
🎨 DESIGN_PHILOSOPHY
ACIDUI is built on a "Premium Industrial" aesthetic:
- Monochrome & High Contrast: Dark mode optimized, sleek interfaces.
- Glassmorphism: Advanced blur and transparency effects.
- Vibrant Highlights: Strategic use of aurora and neon gradients.
- Micro-interactions: Every click and hover feels tactical and responsive.
🧪 TECH_STACK
- React 19: Modern core.
- Vite 7: Ultra-fast build engine.
- Framer Motion: State-of-the-art animation.
- Lucide React: Crisp, industrial iconography.
- Canvas Confetti: High-impact feedback.
📜 LICENSE
System distributed under the MIT License.
[SYSTEM_ID: ACIDUI_ALPHA_v1.0.0] [AUTHOR: korybantes]
