@wu-framework/cli 0.1.0 → 0.2.1

package/README.md

@@ -1,24 +1,56 @@
-# wu-cli
+<p align="center">
+  <img src="https://raw.githubusercontent.com/LuisPadre25/wu-framework/main/wu-logo.png" width="80" alt="Wu CLI" />
+</p>
+
+<h1 align="center">Wu CLI</h1>
+
+<p align="center">
+  <strong>One binary. One port. All your micro-apps.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@wu-framework/cli"><img src="https://img.shields.io/npm/v/@wu-framework/cli.svg?color=6366f1&label=npm" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/zig-0.15.2-f7a41d" alt="Zig 0.15.2" />
+  <img src="https://img.shields.io/badge/frameworks-13-14b8a6" alt="13 frameworks" />
+  <img src="https://img.shields.io/badge/dependencies-0-6366f1" alt="zero deps" />
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License" /></a>
+</p>
+
+<p align="center">
+  <a href="https://www.wu-framework.com">Documentation</a> &middot;
+  <a href="https://www.wu-framework.com/docs/quick-start">Quick Start</a> &middot;
+  <a href="https://github.com/LuisPadre25/wu-framework">Wu Framework</a>
+</p>
 
-**One binary. One port. All your micro-apps.**
+---
 
-Native Zig dev server and CLI toolkit for wu-framework microfrontend applications. Replaces N Vite dev servers with a single process -- one binary that discovers, compiles, and serves every micro-app through a unified HTTP server.
+Native Zig CLI and dev server for [wu-framework](https://www.wu-framework.com) microfrontend applications. Replaces N Vite dev servers with a single process -- one binary that discovers, compiles, builds, and serves every micro-app through a unified HTTP server.
 
----
+## What's New in v0.2.0
+
+- **Production build pipeline** -- `wu build` compiles all micro-apps via Vite in parallel and generates a production shell with theme support
+- **Production server** -- `wu serve` serves the built `dist/` folder with proper static file serving and clean Ctrl+C shutdown
+- **Event-driven mounting** -- production shell uses `wu:app:ready` events instead of `await import()`, eliminating Vite code-splitting deadlocks
+- **Theme system** -- generated shells and app templates use CSS custom properties (`--surface`, `--text`, `--border`, etc.) for dark/light theme propagation
+- **wu-framework.com design tokens** -- shells use the official design system: Indigo `#6366f1`, Teal `#14b8a6`, Zinc palette, Inter font, backdrop blur
+- **13 theme-aware app templates** -- all framework templates (React, Vue, Svelte, Solid, Preact, Lit, Angular, Alpine, Qwik, Stencil, HTMX, Stimulus, Vanilla) respond to shell theme changes
+- **Responsive production shell** -- topbar with backdrop blur, sidebar with framework badges, loading spinners, mobile hamburger menu
+- **Correct Vite entry detection** -- `findEntryFromHtml()` parses Vite's generated `index.html` to find the real entry point instead of picking the first JS file
 
 ## Features
 
 - Native HTTP dev server with SIMD-accelerated request parsing (16 bytes/cycle)
 - Three-tier compilation: Native Zig JSX (0-2ms) -> Compiler Daemon (10-50ms) -> Node fallback (200-400ms)
-- Two-level cache: in-memory (256 entries, mutex-protected) + persistent disk (`.wu-cache/`), 73-138x speedup on warm restart
+- Two-level cache: in-memory (256 entries) + persistent disk (`.wu-cache/`), 73-138x speedup on warm restart
 - NPM module resolution in pure Zig (package.json `exports`, `module`, `main` fields with conditions)
 - TypeScript stripping and bare-specifier import rewriting (`react` -> `/@modules/react`)
 - CSS-as-module imports (`import './style.css'` injects into DOM at runtime)
 - WebSocket (RFC 6455) + SSE-based HMR with 300ms file-watcher polling
 - HTTP keep-alive for connection reuse across requests
-- Interactive project scaffolding (`wu create`)
+- Interactive project scaffolding (`wu create`) with 13 framework choices
 - Auto-discovery of micro-apps from directory structure (no config required)
-- Framework support: React, Preact, Vue, Svelte, Solid, Lit, Angular, Vanilla JS
+- Production build with parallel Vite compilation and optimized shell generation
+- Production server with static file serving
 
 ## Install
 
@@ -29,14 +61,16 @@ npm install -g @wu-framework/cli
 Then use it anywhere:
 
 ```bash
-wu create my-project
+wu create my-project    # Interactive scaffolding
 cd my-project
-wu dev
+wu dev                  # Start dev server on one port
+wu build                # Build for production
+wu serve                # Serve production build
 ```
 
 ### Build from source
 
-If you prefer to build from source (requires [Zig 0.15.2+](https://ziglang.org/download/)):
+Requires [Zig 0.15.2+](https://ziglang.org/download/):
 
 ```bash
 git clone https://github.com/LuisPadre25/wu-cli.git
@@ -50,22 +84,89 @@ zig build
 | Command | Description |
 |---------|-------------|
 | `wu dev` | Start native dev server (default) or Vite processes (`--vite`) |
-| `wu build` | Build all micro-apps in parallel |
-| `wu create` | Interactive project scaffolding (name, frameworks, install) |
+| `wu build` | Build all micro-apps via Vite in parallel, generate production shell |
+| `wu serve` | Serve the production `dist/` folder |
+| `wu create` | Interactive project scaffolding (name, frameworks, npm install) |
 | `wu add <framework> <name>` | Add a new micro-app to an existing project |
 | `wu info` | Show project configuration and status |
-| `wu serve` | Production server (coming soon) |
+
+### `wu create`
+
+Interactive guided scaffolding:
+
+```
+$ wu create my-store
+
+  Wu CLI  v0.2.0
+  Creating a new Wu project...
+
+  Project name: my-store
+
+  Add micro-apps:
+    App name: products
+    Framework: vue
+    App name: orders
+    Framework: react
+    (empty to finish)
+
+  Generated:
+    shell/          HTML shell with sidebar navigation
+    mf-products/    Vue 3 micro-app
+    mf-orders/      React micro-app
+    wu.config.json  Project configuration
+
+  Installing dependencies...
+  Done!
+```
+
+### `wu build`
+
+Builds each micro-app with Vite in parallel and generates a production-ready shell:
+
+```
+$ wu build
+
+  Wu CLI  v0.2.0
+  Building 4 micro-apps for production...
+
+  + shell           (static)
+  + dashboard        3.1s
+  + orders           2.8s
+  + products         3.4s
+  + settings         4.2s
+
+  + wu-manifest.json (4 apps)
+  + dist/index.html (production shell)
+
+  + Build complete: 4 app(s) -> dist/ (5.8s)
+```
+
+### `wu serve`
+
+Serves the built `dist/` folder:
+
+```
+$ wu serve
+
+  Wu CLI  v0.2.0
+  Serving production build from dist/
+
+  Local:   http://localhost:3000/
+  Press Ctrl+C to stop
+```
 
 ## Configuration
 
-wu-cli reads a `wu.config.json` file at the project root. Example:
+wu-cli reads a `wu.config.json` file at the project root:
 
 ```json
 {
+  "name": "my-store",
+  "version": "0.2.0",
   "shell": {
     "dir": "shell",
     "port": 4321,
-    "framework": "astro"
+    "framework": "html"
   },
   "apps": [
     {
@@ -80,35 +181,42 @@ wu-cli reads a `wu.config.json` file at the project root. Example:
       "framework": "react",
       "port": 5005
     }
-  ]
+  ],
+  "proxy": {
+    "port": 3000,
+    "open_browser": true
+  }
 }
 ```
 
-Alternatively, wu-cli auto-discovers micro-apps by scanning subdirectories for the presence of both `vite.config.js` and `package.json`. No configuration file is required for basic usage.
+Alternatively, wu-cli auto-discovers micro-apps by scanning subdirectories for `vite.config.js` + `package.json`. No configuration file is required for basic usage.
 
 ## Architecture
 
 ```
-src/
-  commands/          CLI command handlers (dev, build, create, add, info, serve)
-  runtime/           Dev server core
-  config/            Configuration loading and validation
+wu-cli/
+  src/
+    commands/           CLI command handlers
+      dev.zig           Native dev server orchestration
+      build.zig         Production build pipeline (Vite + shell generation)
+      serve.zig         Production static file server
+      create.zig        Interactive project scaffolding
+      add.zig           Add micro-app to existing project
+      info.zig          Project status display
+      templates/        13 framework app component templates
+    runtime/            Dev server core
+      dev_server.zig    Thread-per-connection HTTP server with keep-alive
+      http_parser.zig   SIMD HTTP/1.1 parser (16 bytes/cycle)
+      resolve.zig       NPM module resolution (exports, module, main)
+      transform.zig     TS stripping + bare-specifier rewriting
+      jsx_transform.zig Native JSX -> createElement (React/Preact)
+      compile.zig       Three-tier compilation with persistent daemon
+      cache.zig         Two-level mtime cache (memory + disk)
+      ws_protocol.zig   WebSocket RFC 6455 (frame parsing, masking)
+      mime.zig          MIME type detection
+    config/             Configuration loading and validation
 ```
 
-### Runtime modules
-
-| Module | Purpose |
-|--------|---------|
-| **dev_server.zig** | Thread-per-connection HTTP server with keep-alive and static file serving |
-| **http_parser.zig** | SIMD HTTP/1.1 request parser (16 bytes/cycle vectorized header scanning) |
-| **resolve.zig** | NPM module resolution in pure Zig (zero Node.js dependency) |
-| **transform.zig** | TypeScript erasure + bare-specifier import rewriting (line-preserving) |
-| **jsx_transform.zig** | Native JSX to createElement transformation (React/Preact, ~0-2ms) |
-| **compile.zig** | Three-tier framework compilation with persistent daemon process |
-| **cache.zig** | Two-level mtime-based cache (in-memory 256 entries + disk `.wu-cache/`) |
-| **ws_protocol.zig** | WebSocket RFC 6455 implementation (frame parsing, masking, handshake) |
-| **mime.zig** | MIME type detection by file extension |
-
 ## Compilation Pipeline
 
 ```
@@ -116,12 +224,14 @@ src/
 .jsx/.tsx (Solid)        ----> Compiler Daemon ----> JS  (~10-50ms)
 .svelte                  ----> Compiler Daemon ----> JS  (~10-50ms)
 .vue                     ----> Compiler Daemon ----> JS  (~10-50ms)
+.ts   (Angular)          ----> esbuild bundle  ----> JS  (~10-50ms)
 .ts                      ----> TS Strip        ----> JS  (~0-1ms)
+.js   (Alpine/HTMX/etc)  ----> passthrough     ----> JS  (~0ms)
 ```
 
 The three tiers are tried in order. Native Zig handles React and Preact JSX with zero external processes. The Compiler Daemon keeps a long-running Node.js process for frameworks that require their own compilers (Svelte, Vue, Solid). If the daemon is unavailable, a one-shot `node -e` fallback is used.
 
-Cache hits bypass all tiers entirely: the mtime of the source file is compared against the cached entry, and the cached output is served directly (~3ms).
+Cache hits bypass all tiers: source mtime is compared against the cached entry, and cached output is served directly (~3ms).
 
 ## Supported Frameworks
 
@@ -132,22 +242,46 @@ Cache hits bypass all tiers entirely: the mtime of the source file is compared a
 | Vue | .vue | Daemon / Node | -- |
 | Svelte | .svelte | Daemon / Node | -- |
 | Solid.js | .jsx, .tsx | Daemon / Node | -- |
+| Angular | .ts | esbuild bundle | -- |
 | Lit | .ts, .js | TS strip only | -- |
+| Alpine.js | .js | Passthrough | -- |
+| Qwik | .jsx | Passthrough | -- |
+| Stencil | .js | Passthrough | -- |
+| HTMX | .js | Passthrough | -- |
+| Stimulus | .js | Passthrough | -- |
 | Vanilla | .js, .ts | TS strip only | -- |
-| Angular | .ts | TS strip only | -- |
+
+## Theme System
+
+Generated shells and app templates support dark/light theme switching via CSS custom properties:
+
+| Variable | Dark | Light | Purpose |
+|----------|------|-------|---------|
+| `--bg` | `#09090b` | `#fafafa` | Page background |
+| `--surface` | `#111113` | `#ffffff` | Card/panel background |
+| `--border` | `#27272a` | `#d4d4d8` | Borders |
+| `--text` | `#fafafa` | `#09090b` | Primary text |
+| `--text2` | `#a1a1aa` | `#52525b` | Secondary text |
+| `--text-muted` | `#3f3f46` | `#a1a1aa` | Muted/label text |
+| `--accent` | `#6366f1` | `#6366f1` | Brand accent (Indigo) |
+| `--teal` | `#14b8a6` | `#14b8a6` | Status/success accent |
+
+All 13 app templates use `var(--surface, #111)` etc. with fallback defaults, so they work both inside a themed shell and standalone.
 
 ## Requirements
 
-- **Node.js 16+** -- for installing via npm (`npm install -g @wu-framework/cli`)
+- **Node.js 16+** -- for installing via npm
 - **Node.js 18+** -- needed at runtime for Svelte, Vue, and Solid compilation (React/Preact use native Zig JSX)
 - **Zig 0.15.2+** -- only needed if building from source
 
 ## Project Stats
 
-- 22 Zig source files, ~2800 lines of runtime code
-- ~250-460KB release binary per platform (Windows, Linux, macOS x64/arm64), zero external Zig dependencies
-- Single-process architecture replaces 8+ simultaneous Vite dev servers
-- Part of the wu-framework microfrontend platform
+- 22 Zig source files, ~3000 lines of runtime code
+- 13 framework app component templates (embedded at compile time)
+- ~250-460KB release binary per platform (Windows, Linux, macOS x64/arm64)
+- Zero external Zig dependencies
+- Single-process architecture replaces 12+ simultaneous Vite dev servers
+- Part of the [wu-framework](https://www.wu-framework.com) microfrontend platform
 
 ## License
 
@@ -155,8 +289,8 @@ MIT
 
 ## Author
 
-Luis Garcia -- Creator of wu-framework
+Luis Garcia -- Creator of [wu-framework](https://www.wu-framework.com)
 
 ---
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow and guidelines.
+*2026 Wu Framework*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu-framework/cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Lightning-fast micro-frontend CLI — scaffold, develop, and build multi-framework apps",
   "license": "MIT",
   "bin": {