docs: enhance README and documentation system

- Update README.md with absolute links for GitHub compatibility
- Create docs/pages/index.md as a synced copy of README with relative links
- Add scripts/sync-readme.mjs to automate README synchronization
- Add scripts/inject-css.mjs and docs/custom-styles.css for styling
- Add interactive getting started tutorial
- Update package.json build scripts to include sync and injection steps

Author: jurra

README.md

@@ -1,81 +1,76 @@
-# QuCat Circuit Generator
 
-A modular and testable project for generating and testing circuits. This application provides a user-friendly GUI to add and manipulate circuit elements like resistors and wires, along with robust testing for the core functionalities.
+<div align="center">
+  <img src="assets/logo.png" alt="QuCat Logo" height="100" style="margin-bottom: 1rem;">
+  
+  # JSCircuit
+
+  **Start designing quantum circuits in your browser right away with jscircuit for your simulations**
+  
+  [![GitHub](https://img.shields.io/badge/GitHub-View%20Source-blue?style=for-the-badge&logo=github)](https://github.com/jurra/qucat-circuit-generator)
+  [![App](https://img.shields.io/badge/Demo-Try%20Live-success?style=for-the-badge&logo=codesandbox)](https://jurra.github.io/qucat-circuit-generator/app/jscircuit.html)
+  [![Docs](https://img.shields.io/badge/Docs-Getting%20Started-orange?style=for-the-badge&logo=gitbook)](https://jurra.github.io/qucat-circuit-generator/tutorial-getting-started.html)
+</div>
 
----
 
-## **Features**
-- Add, delete, and connect circuit elements dynamically via the GUI.
-- Modular architecture with clear separation between UI, application logic, and domain layers.
-- Unit tests for ensuring functionality and maintainability.
-- Bundling with Rollup for optimized builds.
 
 ---
 
-## **Setup and Usage**
+**JSCircuit** is a lightweight, web-based circuit editor designed to generate netlists for **QuCat** simulations. It runs entirely in the browser, offering a modern alternative to desktop-based editors.
 
-### **1. Clone the Repository**
-```bash
-git clone https://github.com/your-repo/qucat-circuit-generator.git
-cd qucat-circuit-generator
-```
+### Why JSCircuit?
 
-### **2. Install Dependencies**
-Install all required dependencies using npm:
-```bash
-npm install
-```
+The project was built to solve two key challenges in the quantum circuit simulation workflow:
 
-### **3. Build the Project**
-Bundle the project with Rollup:
-```bash
-npm run build
-```
-This will generate the bundled JavaScript files in the `dist` folder and copy the `gui.html` file there.
+1.  **Accessibility & Portability**:
+    Many researchers and students work in **Jupyter Notebooks** hosted on JupyterHubs or HPC clusters. JSCircuit provides a zero-installation editor that can be embedded directly into these environments, or run on any device with a modern browser.
 
-### **4. Open the Application**
-After bundling, open the `gui.html` file in the `dist` folder in your browser:
-```bash
-open dist/gui.html
-```
+2.  **Extensibility**:
+    Built with a modular **Hexagonal Architecture**, JSCircuit makes it easy for developers to add custom circuit elements, create new visual renderers, and implement custom commands.
 
-## **Testing**
+## Key Features
 
-### **1. Run All Tests**
-Run the provided test suite using Mocha:
-```bash
-npm test
-```
+-   **Zero Installation**: Runs instantly in any modern web browser.
+-   **QuCat Compatible**: Generates netlist files ready for QuCat simulations.
+-   **Embeddable**: Designed to work within Jupyter Notebooks and web applications.
+-   **Dependency-Free**: Built with native ES6 JavaScript, requiring no heavy frameworks.
+-   **Extensible**: Professional architecture allowing easy addition of new components.
 
-### **2. Test Coverage**
-- **GUIAdapter**: Tests UI bindings and integration with `CircuitService`.
-- **CircuitService**: Validates the addition, deletion, and connection of circuit elements.
+## For Developers
 
----
+### Local Installation
 
-## **Scripts**
+To run the project locally for development:
 
-- **Build**: Bundles the project with Rollup and copies `gui.html` to the `dist` folder.
-  ```bash
-  npm run build
-  ```
+1.  **Clone the repository**:
+    ```bash
+    git clone https://github.com/jurra/qucat-circuit-generator.git
+    cd qucat-circuit-generator
+    ```
 
-- **Test**: Runs all tests in the `tests` folder using Mocha.
-  ```bash
-  npm test
-  ```
+2.  **Install dependencies**:
+    ```bash
+    npm install
+    ```
 
----
+3.  **Build and Serve**:
+    ```bash
+    npm run serve
+    ```
+    This will bundle the application and start a local server at `http://127.0.0.1:8080`.
+
+### Documentation
+
+-   **[Extension Guide](https://jurra.github.io/qucat-circuit-generator/tutorial-extension-guide.html)**: Learn how to add custom elements.
+-   **[Architecture](https://jurra.github.io/qucat-circuit-generator/tutorial-overview.html)**: Understand the system design.
+-   **[API Reference](https://jurra.github.io/qucat-circuit-generator/index.html)**: Detailed code documentation.
+
+##  Build the documentation locally
+```bash
+npm run docs:serve
+```
 
-## **Configuration Details**
+## Licensed under the MIT License.
 
-### **Rollup Config**
-Rollup bundles the project into the `dist` folder for optimized performance. The configuration ensures all dependencies are correctly resolved and minified.
+Technische Universiteit Delft hereby disclaims all copyright interest in the program "JSCircuit" written by the Author(s).
 
-### **Scripts in `package.json`**
-```json
-"scripts": {
-    "test": "mocha 'tests/**/*.test.js'",
-    "build": "rollup -c && cp gui.html dist/"
-}
-```
+— Prof. Paulien Herder, Dean of the faculty of Applied Sciences at TU Delft