fiboui 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# FiboUI
+
+A Flutter/SwiftUI-inspired React UI framework with builder pattern and theme system.
+
+## Installation
+
+```bash
+npm install fiboui
+```
+
+## Quick Start
+
+```tsx
+import { FiboThemeProvider, Container, Text, Button, Row } from 'fiboui';
+import 'fiboui/dist/style.css';
+
+function App() {
+  return (
+    <FiboThemeProvider theme="material">
+      {Container()
+        .padding("8")
+        .children([
+          Text("Hello FiboUI!")
+            .type("h1")
+            .fontSize(32)
+            .fontWeight("bold"),
+          
+          Row()
+            .spacing("4")
+            .children([
+              Button("Click me")
+                .variant("elevated")
+                .onPress(() => console.log("Clicked!")),
+              
+              Button("Outlined")
+                .variant("outlined")
+            ])
+        ])
+        .build()}
+    </FiboThemeProvider>
+  );
+}
+```
+
+## Features
+
+- 🎨 **SwiftUI-Style Builder Pattern** - Chainable, expressive component composition
+- 🎭 **Multi-Theme System** - Material, Cupertino, and Web themes with dynamic switching
+- ⚡ **Tailwind CSS Integration** - Native Tailwind support with theme consistency
+- 📱 **Responsive Design** - Built-in responsive styling system
+- 🔷 **TypeScript-First** - Full type safety and IntelliSense support
+
+## Themes
+
+Switch between themes dynamically:
+
+```tsx
+import { useFiboTheme } from 'fiboui';
+
+function ThemeSwitcher() {
+  const { theme, setTheme } = useFiboTheme();
+  
+  return Row()
+    .spacing("md")
+    .children([
+      Button("Material").onPress(() => setTheme('material')),
+      Button("Cupertino").onPress(() => setTheme('cupertino')),
+      Button("Web").onPress(() => setTheme('web'))
+    ])
+    .build();
+}
+```
+
+## Components
+
+### Layout
+- `Container` - Flexible container
+- `Row` - Horizontal layout
+- `Column` - Vertical layout
+- `Spacer` - Spacing element
+- `Center` - Centering wrapper
+- `Line` - Custom horizontal container
+
+### Content
+- `Text` - Text with typography styles
+- `Image` - Image with SwiftUI-like methods
+
+### Interactive
+- `Button` - Button with variants
+
+### Structure
+- `Card` - Information card
+- `Banner` - Status banner
+- `List` - Icon-title-subtitle list
+- `Tags` - Badge tags
+- `Box` - Container wrapper
+- `Table` - Data table
+
+## License
+
+MIT