added readme.md

Author: pavanscales

.gitignore

@@ -0,0 +1,82 @@
+# === Rust ===
+/target/
+**/*.rs.bk
+Cargo.lock
+*.rlib
+*.dSYM/
+
+# === JavaScript / TypeScript ===
+node_modules/
+dist/
+build/
+*.log
+*.tsbuildinfo
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# === Bun / Deno (if used) ===
+.bun/
+deno.lock
+deno_dir/
+
+# === Environment Files ===
+.env
+.env.*.local
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# === Editor / IDE ===
+.vscode/
+.idea/
+*.code-workspace
+*.sublime*
+*.sw?
+
+# === OS / System Files ===
+.DS_Store
+Thumbs.db
+ehthumbs.db
+Icon?
+
+# === Coverage / Reports ===
+coverage/
+*.lcov
+.nyc_output/
+test-results/
+reports/
+
+# === Binary / Output / Debug ===
+*.out
+*.exe
+*.obj
+*.dll
+*.class
+*.wasm
+*.map
+
+# === Logs / Temp / Cache ===
+*.tmp
+*.temp
+.cache/
+.pnp.*
+*.log
+*.pid
+*.seed
+
+# === Git ===
+*.orig
+*.rej
+*.patch
+*.bak
+
+# === Benchmarks ===
+/benches/*.log
+/tests/output/
+
+# === Custom ===
+/docs/gen/
+*.iml
+*.lock-wip

README.md

@@ -1 +1,75 @@
-"# nullreact" 
+Here’s a **clean, world-class `README.md`** you can copy-paste directly:
+
+````md
+# nullReact
+
+> ZeroRuntime, CompilerFirst reactive engine for the web.  
+> FineGrained reactivity, ExtremeSpeed, and `<1KB` runtime.
+
+---
+
+nullReact is a blazing-fast alternative to traditional React frameworks. Built from scratch in Rust, it compiles JSX to zero-runtime JavaScript with fine-grained reactivity and signal-based updates — all in under 1KB of runtime.
+
+## ✨ Features
+
+- ⚡ **Compiler-First**: Converts JSX directly to reactive JavaScript.
+- 🔁 **Signals + Effects**: Built-in fine-grained reactivity system.
+- 🧠 **No Virtual DOM**: Direct DOM updates for extreme performance.
+- 📦 **<1KB Runtime**: Includes a minimal runtime shipped separately.
+- 🛠️ **Written in Rust**: Built for speed and safety.
+
+## 🚀 Quick Start
+
+```bash
+# Clone and build
+git clone https://github.com/pavanscales/nullreact
+cd nullreact
+make build
+
+# Run benchmark
+make bench
+````
+
+## 🧪 Examples
+
+```jsx
+examples/1m-signals.jsx    // 1 Million Signals, outperforms React
+examples/10k-filter.jsx    // 10,000-item filtering demo
+```
+
+## 📁 Folder Structure
+
+```
+nullreact/
+├── src/
+│   ├── lib.rs             # CLI + Compiler entry
+│   ├── jsx.rs             # JSX → AST
+│   ├── emitter.rs         # AST → Optimized JS
+│   ├── signals.rs         # Signals and Effects system
+│   ├── runtime.js         # DOM runtime
+│   └── bench.rs           # Performance tests
+├── dist/                  # Emitted JS output
+│   └── runtime.js         # Runtime for importing
+├── examples/              # JSX usage demos
+├── Makefile               # Build, test, benchmark
+├── README.md              # You are here
+├── LICENSE                # MIT License
+└── .gitignore             # Clean ignored files
+```
+
+## 💡 Philosophy
+
+* Reactivity should be **compiled**, not interpreted.
+* Runtime should be **opt-in**, not bloated.
+* Performance should be **measurable**, not theoretical.
+
+## 📜 License
+
+MIT © [Pawan Pediredla](mailto:pawanpediredla)
+
+GitHub: [@pavanscales](https://github.com/pavanscales)
+
+```
+
+Let me know if you want badges, logo, or GitHub Actions status added to it, brother.
+```