@aahrbitx/arc-it

v1.1.0

Published

4 months ago

Arc-it.js - Modern React theming library with CSS variables and Tailwind CSS support

Arc-it.js 🎨

Modern React theming library with CSS variables and Tailwind CSS support

🚀 Quick Start

Installation

npm install @aahrbitx/arc-it

⚠️ Important: This package requires React 18+ and lucide-react as peer dependencies.

Required Peer Dependencies

npm install react react-dom lucide-react

Basic Usage

import { DynamicProvider, DynamicSwitcher } from '@aahrbitx/arc-it';

function App() {
  return (
    <DynamicProvider>
      <div>
        <h1>My App</h1>
        <DynamicSwitcher />
      </div>
    </DynamicProvider>
  );
}

🔧 Features

🎨 Dynamic Theme Detection: Automatically discovers themes from JSON files
🌙 Dark/Light Mode: Built-in theme switching with smooth transitions
🌍 Multi-language Support: Dynamic content switching
🎯 Tailwind CSS Integration: Seamless Tailwind support
⚡ React 18+ Ready: Concurrent features and Suspense support
🔒 Security Focused: Built-in security validation
📱 Mobile Optimized: Responsive design components
🚀 Smart Content Loading: Automatic Speed + SEO + Security optimization

📦 Package Information

Size: ~20KB gzipped
Dependencies: 0 runtime dependencies (peer dependencies only)
Security: Regular security audits and vulnerability scanning
Performance: Optimized for modern React rendering

🛡️ Security & Performance

Why Choose Arc-it?

Zero Runtime Dependencies: Only peer dependencies, no bundled packages
Security Audited: Regular npm audit and security testing
Fast Installation: Minimal package size, no unnecessary dependencies
Modern Architecture: Built for React 18+ concurrent features

Security Features

Input sanitization
XSS protection
Content validation
Secure theme switching

📚 Documentation

Quick Start Guide - Get up and running in minutes
Content Styles - Customize your content
Theme Integration - React compatibility details
Security Guide - Security best practices
Error Troubleshooting - Common issues and solutions
Smart Content Integration - Automatic Speed + SEO + Security

🚨 Troubleshooting

Installation Issues

If you encounter high severity vulnerabilities or slow installation:

Clear npm cache: npm cache clean --force
Use latest version: npm install @aahrbitx/arc-it@latest
Check peer dependencies: Ensure React 18+ and lucide-react are installed

Common Issues

High severity vulnerabilities: Usually caused by outdated peer dependencies
Slow installation: Ensure you're using the latest package version
Build errors: Check React version compatibility (18+ required)

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🔗 Links

Built with ❤️ by AahrbitX