docs(README): add live demo badges + quick links; fix header; DCO sign-off block, normalize headings (remove filename H1s); clean README top section

Author: jaimonorle

.github/workflows/gh-pages.yml

@@ -0,0 +1,33 @@
+name: Deploy demos to GitHub Pages
+on:
+  push:
+    branches: [ feat/builder-ui-v1 ]  # change if needed
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm ci
+      - run: npm run build
+      - name: Prepare site
+        run: |
+          mkdir -p site/demo
+          cp -r demo/*.html site/demo/
+          cp -r dist site/dist
+      - uses: actions/upload-pages-artifact@v3
+        with: { path: 'site' }
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

CODE_OF_CONDUCT.md

@@ -1,4 +1,4 @@
-# CODE_OF_CONDUCT.md
+# Code of Conduct
 
 This project follows the [Contributor Covenant](https://www.contributor-covenant.org/) Code of Conduct. By participating, you agree to uphold a harassment‑free, inclusive environment. Reports: open an issue or contact the maintainers privately.
 

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# CONTRIBUTING.md
+# Contributing
 
 Thanks for considering a contribution! 🙌 This project welcomes fixes, features, docs, and examples.
 

README.md

@@ -1,6 +1,16 @@
-# README.md
+# formBuilder-ConditionalLogic
 
 [![DCO](https://img.shields.io/badge/DCO-1.1-blue.svg)](https://developercertificate.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/jaimonorle/formBuilder-ConditionalLogic?display_name=tag)](https://github.com/jaimonorle/formBuilder-ConditionalLogic/releases)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-orange.svg)](https://www.conventionalcommits.org/)
+[![Pages](https://github.com/jaimonorle/formBuilder-ConditionalLogic/actions/workflows/gh-pages.yml/badge.svg)](https://github.com/jaimonorle/formBuilder-ConditionalLogic/actions/workflows/gh-pages.yml)
+[![Builder Demo](https://img.shields.io/badge/demo-Builder%20Demo-blue.svg)](https://jaimonorle.github.io/formBuilder-ConditionalLogic/demo/builder-static.html)
+[![Render Demo](https://img.shields.io/badge/demo-Render%20Demo-blue.svg)](https://jaimonorle.github.io/formBuilder-ConditionalLogic/demo/render-static.html)
+
+**Quick Links:** [Quick Start](#quick-start) · [Demos](#installation) · [Renderer API](#renderer-api) · [Builder API](#builder-api) · [Contributing](CONTRIBUTING.md) · [Code of Conduct](CODE_OF_CONDUCT.md) · [Changelog](CHANGELOG.md) · [Security](SECURITY.md) · [License](LICENSE)
+
 
 A lightweight, name‑based **Conditional Logic** toolkit for [formBuilder](https://github.com/kevinchappell/formBuilder). Add show/hide/require/enable/disable behaviors to fields and containers without writing custom code.
 
@@ -190,29 +200,15 @@ attachLogicGroupsManager(toolbarEl, { getAvailableFields, getFieldValues });
 
 ---
 
-### DCO: sign-off required
+## Contributing
 
-We follow the **Developer Certificate of Origin**. Please sign off your commits.
-
-```bash
-# set your real name and email once (must match sign-off)
-git config user.name  "Your Real Name"
-git config user.email "you@example.com"
-
-# sign off a new commit
-git commit -s -m "feat: add Visual Groups Editor"
-
-# if you forgot, amend the last commit
-git commit --amend -s --no-edit
-# then push safely
-git push --force-with-lease
-```
+We welcome PRs! Please read [CONTRIBUTING.md](CONTRIBUTING.md) and sign off your commits per the [DCO](https://developercertificate.org/).
+Also see our [Code of Conduct](CODE_OF_CONDUCT.md), [Security policy](SECURITY.md), and [Changelog](CHANGELOG.md).
 
-Read more: [https://developercertificate.org/](https://developercertificate.org/)
 
 ## Acknowledgements
 
-* Inspired by community demand and prior work like **formbuilder_depends**.
+* Inspired by community demand and prior work like [**formbuilder_depends**](https://github.com/rendezz/formbuilder_depends).
 
 ## License
 

SECURITY.md

@@ -1,4 +1,4 @@
-# SECURITY.md
+# Security Policy
 
 Please report security issues privately via email or a confidential issue. Do not create public issues for vulnerabilities until a fix is available.