Added more info for newcomers

Author: silky-x0

README.md

@@ -10,6 +10,102 @@ Rimmel is a powerful, fast and lightweight JavaScript UI library for creating we
 
 It implements [RML](https://github.com/ReactiveHTML/reactive-markup), the Reactive Markup which makes your HTML work with Streams in a seamless way.
 
+## Quick Start
+
+### Installation
+
+```bash
+# Using npm
+npm install rimmel rxjs
+
+# Using yarn 
+yarn add rimmel rxjs
+
+# Using pnpm
+pnpm add rimmel rxjs
+```
+
+### Basic Usage
+
+```js
+import { rml } from "rimmel";
+import { Subject } from "rxjs";
+
+const counter = new Subject();
+
+document.body.innerHTML = rml`
+  <button onclick="${counter}">Click me</button>
+  <div>Clicks: ${counter}</div>
+`;
+```
+
+## Key Features
+
+- **Stream-First Architecture**: Everything is a stream - events, data, UI updates
+- **No Virtual DOM**: Direct DOM updates via optimized "sinks"
+- **Tiny Bundle Size**: Core is just 2.5KB, tree-shakeable imports
+- **Zero Build Requirements**: Works with plain JavaScript
+- **Automatic Memory Management**: Handles subscription cleanup
+- **Built-in Suspense**: Automatic loading states with BehaviorSubject
+- **Web Components Support**: Create custom elements easily
+- **TypeScript Support**: Full type definitions included
+
+## Core Concepts
+
+### Sources (Input)
+- DOM Events (`onclick`, `onmousemove`, etc)
+- Promises 
+- RxJS Observables
+- Custom Event Sources
+
+### Sinks (Output)
+- DOM Updates
+- Class Management
+- Style Updates
+- Attribute Changes
+- Custom Sinks
+
+## Available Sinks
+
+The library includes specialized sinks for common UI operations:
+
+- `InnerHTML` - Update element content 
+- `InnerText` - Safe text updates
+- `Class` - Manage CSS classes
+- `Style` - Update styles
+- `Value` - Form input values
+- `Disabled` - Toggle disabled state
+- `Readonly` - Toggle readonly state
+- `Removed` - Remove elements
+- `Sanitize` - Safe HTML rendering
+- `AppendHTML` - Append content
+- `PrependHTML` - Prepend content
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm run test
+
+# Build library
+npm run build
+
+# Run demo app
+npm run kitchen-sink
+```
+
+## Examples
+
+Check out our examples:
+
+- [Basic Demos](https://stackblitz.com/@dariomannu/collections/rimmel-js-getting-started)
+- [Advanced Patterns](https://stackblitz.com/@dariomannu/collections/rimmel-js-experiments) 
+- [Web Components](https://stackblitz.com/@dariomannu/collections/web-components)
+- [Web Workers](https://stackblitz.com/@dariomannu/collections/web-workers)
+
 ## Getting started
 If you are new to reactive streams, there is a [3m crash-course](https://medium.com/@fourtyeighthours/the-mostly-inaccurate-crash-course-for-reactive-ui-development-w-rxjs-ddbb7e5e526e) tailored for UI development with Rimmel, arguably the simplest RxJS introduction around to get you started.