docs: update docs, remove unused files from demo

Author: Austin1serb

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,33 +1,53 @@
 ---
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
+name: 🐛 Bug report
+about: Report a problem so we can fix it
+title: '[Bug]: '
+labels: ['bug']
 assignees: ''
+---
+
+## 🐞 Description
+
+Clear and concise description of the bug.
+
+---
+
+## 🔁 Reproduction Steps
+
+1. Go to `…`
+2. Perform `…`
+3. Observe `…`
+
+_Provide a minimal reproduction (CodeSandbox, repo, etc.) if possible._
+
+---
+
+## ✅ Expected Behavior
+
+What you expected to happen.
+
+---
+
+## 🚫 Actual Behavior
+
+What actually happened.
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+## 🖥 Environment
+
+- **OS:** [e.g. macOS 14.5]
+- **Browser / Runtime:** [e.g. Chrome 125, Node 18.18.2]
+- **Package Version:** [`@austinserb/[email protected]`]
 
-**Reproduction steps**
-Provide step-by-step instructions so we can reproduce the issue. Include a minimal repo or code snippet if possible.
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+---
 
-**Environment info**
- - OS: [e.g. macOS 14]
- - Browser: [e.g. Chrome 116]
- - Node version: [e.g. 20.x]
- - Package version: [e.g. [email protected]]
+## 📸 Screenshots / Logs (if applicable)
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+_Please add visual proof or error logs here._
+
+---
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+## 🧩 Additional Context
 
-**Additional context**
-Add any other context about the problem here.
+Any other details? Custom config, frameworks in use, relevant links?

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,31 +1,33 @@
 ---
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
+name: 🚀 Feature request
+about: Suggest an improvement or new idea for React Zero-UI
+title: '[Feature]: '
+labels: ['enhancement']
 assignees: ''
+---
+
+## ✨ Problem
+
+Is your feature request related to a problem or pain point?
+
+> Ex: "I'm often frustrated when trying to do X because…"
 
 ---
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+## ✅ Proposed Solution
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+How would you like this to work? Be specific.
 
-**Reproduction or use case**
-Provide steps or a short scenario that demonstrates when this feature would be useful.
+---
 
-**Environment info**
- - OS: [e.g. macOS 14]
- - Browser: [e.g. Chrome 116]
- - Node version: [e.g. 20.x]
+## 🔄 Alternatives Considered
 
-**Expected behavior**
-What outcome do you expect when this feature is implemented?
+Have you tried workarounds or other approaches? Share them here.
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+---
+
+## 📎 Additional Context
 
-**Additional context**
-Add any other context or screenshots about the feature request here.
+Add screenshots, references, or related discussions if relevant.
+
+---

.github/pull_request_template.md

@@ -1,5 +1,32 @@
+## Summary
+
+<!-- Briefly describe the purpose of this PR and what it changes. If fixing an issue, reference it with "Closes #123". -->
+
+---
+
+## Type of Change
+
+<!-- Select one or more by replacing `[ ]` with `[x]` -->
+
+- [ ] 🐛 Bug fix  
+- [ ] ✨ New feature  
+- [ ] 🛠 Refactor  
+- [ ] 🧪 Test improvement  
+- [ ] 📝 Docs update  
+- [ ] ⚙️ CI/tooling  
+
+---
+
 ## Checklist
-- [ ] All tests are passing
-- [ ] Documentation updated if needed
-- [ ] Lint and formatting run
-- [ ] PR title and description clearly describe the change
+
+- [ ] All tests pass (`pnpm test`)
+- [ ] Linting and formatting pass (`pnpm lint && pnpm format`)
+- [ ] PR title follows semantic commit format (`feat:`, `fix:`, etc.)
+- [ ] Changes are documented (README, JSDoc, or comments if needed)
+- [ ] Ready for review — not a draft
+
+---
+
+## Notes for Reviewer
+
+<!-- Optional: Anything specific you'd like feedback on, or explain complex decisions here. -->

.github/workflows/ci.yml

@@ -8,6 +8,7 @@ on:
       - '.github/workflows/ci.yml'
       - 'scripts/**'
       - 'pnpm-lock.yaml'
+      - '!packages/**/README.md'
   pull_request:
 
 concurrency:

.prettierignore

@@ -1 +1,6 @@
 /examples
+pnpm-lock.yaml
+packages/core/__tests__/fixtures/vite/vite.config.ts
+packages/core/__tests__/fixtures/next/tsconfig.json
+packages/core/__tests__/fixtures/next/postcss.config.mjs
+attributes.**

CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing to React Zero-UI
+
+**Thanks for stopping by.** This project exists because builders like you push boundaries. If you're here to experiment, break things, or ship speed — you're in the right place.
+
+---
+
+## ⚡ Core Philosophy
+
+**React Zero-UI** is built on a radical idea:
+
+> UI state should not require re-rendering.  
+> CSS and `data-*` attributes can be enough.
+
+It's fast because it **skips the VDOM entirely** — no state triggers, no diffing, no component redraws.
+
+### If you contribute:
+Stay **pre-rendered, declarative, and brutally fast.**
+
+---
+
+## 🧠 Monorepo Structure
+
+```
+packages/
+├── core     → @austinserb/react-zero-ui (library logic + postcss)
+└── cli      → create-zero-ui (npx installer)
+```
+
+---
+
+## ⚙️ Local Setup
+
+```bash
+pnpm bootstrap    # builds + installs local tarball into test fixtures
+pnpm test         # runs all tests (unit + E2E)
+```
+
+> Node 18+ and PNPM required.  
+> Run from repo root.
+
+---
+
+## ✅ Contribution Flow
+
+### 1. [Start a Discussion](https://github.com/Austin1serb/React-Zero-UI/discussions)
+
+For questions, proposals, or early feedback. Share ideas before building.
+
+### 2. [Open an Issue](https://github.com/Austin1serb/React-Zero-UI/issues)
+
+Use the templates.
+
+* **Bug** → Include steps to reproduce, expected vs. actual behavior.
+* **Feature** → Explain the *why*, and sketch a possible approach.
+
+### 3. Pull Requests
+
+* Use semantic commit prefixes: `feat:`, `fix:`, `chore:`, `refactor:`
+* Add tests if you touch logic, CLI, or rendering behavior.
+* Keep PRs focused — one change per pull.
+* Fill out the PR template — no empty descriptions.
+
+---
+
+## 🧪 Test Commands
+
+```bash
+pnpm test:unit      # Core logic tests
+pnpm test:cli       # CLI creation flow
+pnpm test:vite      # E2E tests on Vite fixture
+pnpm test:next      # E2E tests on Next.js fixture
+pnpm test           # Runs all of the above
+```
+
+---
+
+## 🤝 Code of Conduct
+
+Keep it respectful. Push ideas hard, not people.
+
+---
+
+## 📬 Contact
+
+> Got a big idea? DM me:  
+> [linkedin.com/in/austin-serb](https://www.linkedin.com/in/austin-serb/)
+

README.md

@@ -4,11 +4,10 @@
 
 Pre‑render your UI once, flip a `data-*` attribute to update — that's it.
 
-<a href="https://bundlephobia.com/package/@austinserb/[email protected]" target="_blank" rel="noopener noreferrer"><img src="https://badgen.net/bundlephobia/min/@austinserb/[email protected]" alt="npm version" /> </a><a href="https://www.npmjs.com/package/@austinserb/react-zero-ui" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/npm/v/@austinserb/react-zero-ui" alt="npm version" /></a> <a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a> ![CI](https://github.com/austin1serb/react-zero-ui/actions/workflows/ci.yml/badge.svg?branch=main)
+<a href="https://bundlephobia.com/package/@austinserb/[email protected]" target="_blank" rel="noopener noreferrer"><img src="https://badgen.net/bundlephobia/minzip/@austinserb/[email protected]" alt="npm version" /> </a><a href="https://www.npmjs.com/package/@austinserb/react-zero-ui" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/npm/v/@austinserb/react-zero-ui" alt="npm version" /></a> <a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a> ![CI](https://github.com/austin1serb/react-zero-ui/actions/workflows/ci.yml/badge.svg?branch=main)
 
 ---
 
-
 ## 📚 Quick Links
 
 - [⚡️ Quick Start](#️-quick-start)
@@ -130,7 +129,7 @@ const [staleValue, setValue] = useUI<'open' | 'closed'>('sidebar', 'closed');
 ```
 
 - `key` → becomes `data-{key}` on `<body>`.
-- `defaultValue` → optional, prevents FOUC.
+- `defaultValue` → SSR, prevents FOUC.
 - **Note:** the returned `staleValue` does **not** update (`useUI` is write‑only).
 
 ### Tailwind variants
@@ -148,18 +147,18 @@ Any `data-{key}="{value}"` pair becomes a variant: `{key}-{value}:`.
 1. **`useUI`** → writes to `data-*` attributes on `<body>`.
 2. **Babel plugin** → scans code, finds every `key/value`, injects them into **PostCSS**.
 3. **PostCSS plugin** → generates static Tailwind classes **at build‑time**.
-4. **Runtime** → changing state only touches the attribute — no VDOM, no reconciliation, no re‑paint.
+4. **Runtime** → changing state only touches the attribute — no VDOM, no reconciliation, ZERO re‑renders.
 
 ---
 
 ## ✅ Features
 
 - **Zero React re‑renders** for UI‑only state.
 - **Global setters** — call from any component or util.
-- **Tiny**: < 1 KB gzipped runtime.
+- **Tiny**: < 391 Byte gzipped runtime.
 - **TypeScript‑first**.
 - **SSR‑friendly** (Next.js & Vite SSR).
-- **Framework‑agnostic CSS** — generated classes work in plain HTML / Vue / Svelte as well.
+- **Framework‑agnostic CSS** — generated classes work in plain HTML / Vue / Svelte as well with extra config.
 
 ---
 

examples/demo/src/app/layout.tsx

@@ -18,6 +18,7 @@ export default function RootLayout({
   children: React.ReactNode;
 }>) {
   return (
+    
     <html lang="en">
       <body className="py-24 md:py-10 antialiased" {...bodyAttributes}>
         <TopBarV2 />