docs(root): readme cleaned

Author: Sebastian Schürmann

README.md

@@ -4,126 +4,22 @@
 
 banira.js is an open-source toolchain designed for the development of web components using vanilla JavaScript. It simplifies the process by eliminating the need for bundlers and frameworks, focusing instead on modern CSS and web standards.
 
-## Features
+| Package | Description | 
+|----|----|----|
+| [banira](./packages/banira/README.md) | A toolchain for developing web components using vanilla JavaScript | 
+| [banira-cli](./packages/banira-cli) | A CLI tool for banira |
 
-* **Zero-Config Setup** - Get started quickly with sensible defaults
-* **TypeScript First** - Full TypeScript support with type-safe components
-* **Virtual Filesystem** - Test components with an in-memory filesystem
-* **Modern Testing** - Testing utilities with JSDOM integration
-* **Standards Compliant** - Built on web standards and modern JavaScript
-* **Developer Experience** - Hot reload, error handling, and debugging tools
+## Getting Started
 
-## Quick Start
+This softwawer is a development build and work in progress. Your best shot will be to build it using a unix or linux machine. 
 
-```bash
-# Install the CLI globally
-npm install -g @banira/cli
+* make clean - remove all dependencies and build artifacts
+* make bootstrap - install all dependencies
+* make test - run all tests
+* make lint - lint all TypeScript files
+* make docs - generate the API documentation for banira
 
-banira build
-```
-
-## Component Development
-
-Create a new component with TypeScript:
-
-```typescript
-class MyCircle extends HTMLElement {
-    private _size: number = 50;
-    private _color: string = 'red';
-
-    constructor() {
-        super();
-        this.attachShadow({ mode: 'open' });
-        this.render();
-    }
-
-    static get observedAttributes() {
-        return ['size', 'color'];
-    }
-
-    // ... see documentation for full example
-}
-
-customElements.define('my-circle', MyCircle);
-```
-
-## Testing
-
-banira provides powerful testing utilities:
-
-```typescript
-import { TestHelper } from 'banira';
-
-describe('MyComponent', () => {
-    let context;
-
-    beforeEach(async () => {
-        const helper = new TestHelper();
-        context = await helper.mountAsScript('my-component', componentCode);
-    });
-
-    it('should render correctly', () => {
-        const component = context.querySelector('my-component');
-        assert.ok(component);
-    });
-});
-```
-
-## CLI Commands
-
-### Component Commands
-```bash
-# Create a new component
-banira create <name>
-
-# Build components
-banira build [options] <files...>
-
-# Start development server
-banira serve [options]
-```
-
-### Compiler Options
-```bash
-# Compile TypeScript files
-banira compile [options] <files...>
-
-Options:
-  -p, --project <path>  Path to tsconfig.json
-  -o, --outDir <path>   Output directory
-  -w, --watch          Watch mode
-  --sourceMaps        Generate source maps
-```
-
-## Development
-
-### Setup Development Environment
-
-```bash
-# Clone the repository
-git clone https://github.com/yourusername/banira.js.git
-
-# Install dependencies
-make bootstrap
-
-# Run tests
-make test
-
-# Clean build artifacts
-make clean
-```
-
-### Project Structure
-
-- `packages/banira`: Core library with compiler and testing utilities
-- `packages/banira-cli`: Command-line interface
-- `packages/component-my-circle`: Example component implementation
-
-### Development Workflow
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests
-5. Submit a pull request
+## Examples
 
+* [my-circle](./packages/component-my-circle/README.md)
+* [webaudio-controls](./packages/component-webaudio/README.md)

packages/component-my-circle/README.md

@@ -0,0 +1,2 @@
+# my-circle 
+