docs: setup gh-pages deployment

* rename volt to voltx

Author: desertthunder

.github/workflows/deploy-docs.yml

@@ -0,0 +1,61 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build documentation
+        run: pnpm docs:build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -1,4 +1,6 @@
-# Volt.js
+# VoltX.js
+
+> ⚠️ **Pre-release Software**: VoltX.js is in active development. Breaking changes are expected until v1.0. Use in production at your own risk.
 
 ## Philosophy/Goals
 

docs/.vitepress/config.ts

@@ -5,8 +5,9 @@ import { u } from "./utils";
  * @see https://vitepress.dev/reference/site-config
  */
 export default defineConfig({
-  title: "Volt.js",
+  title: "VoltX.js",
   description: "A reactive, hypermedia framework.",
+  base: "/volt/",
   appearance: "dark",
   themeConfig: {
     nav: [{ text: "Home", link: "/" }, { text: "Overview", link: "/overview" }, { text: "CSS", link: "/css/volt-css" }],

docs/api/binder.md

@@ -5,11 +5,11 @@ updated: 2025-10-18
 
 # binder
 
-Binder system for mounting and managing Volt.js bindings
+Binder system for mounting and managing VoltX.js bindings
 
 ## mount
 
-Mount Volt.js on a root element and its descendants and binds all data-volt-* attributes to the provided scope.
+Mount VoltX.js on a root element and its descendants and binds all data-volt-* attributes to the provided scope.
 Returns a cleanup function to unmount and dispose all bindings.
 
 ```typescript

docs/api/events.md

@@ -5,7 +5,7 @@ updated: 2025-10-18
 
 # Event Handling
 
-Volt.js provides declarative event handling through `data-volt-on-*` attributes with automatic access to special scoped references.
+VoltX provides declarative event handling through `data-volt-on-*` attributes with automatic access to special scoped references.
 
 ## Event Binding Syntax
 
@@ -35,7 +35,7 @@ The `$event` reference provides access to the native browser event object.
 
 ## Event Types
 
-Volt.js aims to support all standard DOM events through `data-volt-on-*`:
+VoltX.js aims to support all standard DOM events through `data-volt-on-*`:
 
 **Mouse Events:**
 
@@ -66,7 +66,7 @@ Volt.js aims to support all standard DOM events through `data-volt-on-*`:
 
 ## Implementation Details
 
-When an event handler is bound, Volt.js:
+When an event handler is bound, VoltX.js:
 
 1. Creates a new scope that extends the component scope
 2. Injects `$el` (the bound element) and `$event` (the event object) into this scope

docs/api/lifecycle.md

@@ -5,7 +5,7 @@ updated: 2025-10-18
 
 # lifecycle
 
-Global lifecycle hook system for Volt.js
+Global lifecycle hook system for VoltX.js
 Provides beforeMount, afterMount, beforeUnmount, and afterUnmount hooks
 
 ## registerGlobalHook

docs/api/plugin.md

@@ -5,12 +5,12 @@ updated: 2025-10-18
 
 # plugin
 
-Plugin system for extending Volt.js with custom bindings
+Plugin system for extending VoltX.js with custom bindings
 
 ## registerPlugin
 
 Register a custom plugin with a given name.
-Plugins extend Volt.js with custom data-volt-* attribute bindings.
+Plugins extend VoltX.js with custom data-volt-* attribute bindings.
 
 ```typescript
 export function registerPlugin(name: string, handler: PluginHandler): void

docs/bindings.md

@@ -1,4 +1,4 @@
-# Volt Bindings
+# VoltX Bindings
 
 Bindings connect reactive state to the DOM using `data-volt-*` attributes. Each binding evaluates expressions and updates the DOM when dependencies change.
 
@@ -56,7 +56,7 @@ The `data-volt-class` binding toggles CSS classes based on an object expression:
 
 Each key in the object is a class name. When the corresponding value is truthy, the class is added; when falsy, the class is removed.
 
-Class names with hyphens or spaces must be quoted. The binding preserves existing classes not managed by Volt.js.
+Class names with hyphens or spaces must be quoted. The binding preserves existing classes not managed by VoltX.js.
 
 ## Event Bindings
 
@@ -372,7 +372,8 @@ Signal changes update the URL, and URL changes (back/forward navigation) update
 Register custom bindings for domain-specific behavior using the plugin API:
 
 ```js
-import { registerPlugin } from '@voltjs/volt';
+import { registerPlugin } from 'voltx.js';
+// or: import { registerPlugin } from '@voltx/core';
 
 registerPlugin('tooltip', (ctx) => {
   const message = ctx.evaluate(ctx.element.getAttribute('data-volt-tooltip'));

docs/css/volt-css.md

@@ -335,7 +335,7 @@ Respecting user preferences improves accessibility and reduces eye strain. Autom
 
 ## License
 
-Part of the Volt.js project. MIT licensed.
+Part of the VoltX project. MIT licensed.
 
 ## Further Reading
 

docs/expressions.md

@@ -1,6 +1,6 @@
 # Expression Evaluation
 
-Volt.js evaluates JavaScript-like expressions in HTML templates using a sandboxed recursive descent parser.
+VoltX.js evaluates JavaScript-like expressions in HTML templates using a sandboxed recursive descent parser.
 The evaluator is CSP-compliant and does not use `eval()` or `new Function()`.
 
 ## Supported Syntax