Merge pull request #397 from RtlZeroMemory/edit-readme

Refine README positioning

Author: RtlZeroMemory

README.md

@@ -2,31 +2,31 @@
 
 > **Status: pre-alpha.** Rezi is under active development. Public APIs, native ABI details, and behavior may change between releases. It is not yet recommended for production workloads.
 
-Rezi is a TypeScript framework for deterministic, native-backed terminal applications on Node.js and Bun. It provides a declarative widget API, predictable input and rendering behavior, and a rendering pipeline powered by the [Zireael engine](https://github.com/RtlZeroMemory/Zireael) written in C.
+Rezi is a TypeScript framework for building serious terminal applications on Node.js and Bun. It gives you structured layout, focus and input handling, routing, widgets, testing tools, and a native-backed rendering pipeline powered by the [Zireael engine](https://github.com/RtlZeroMemory/Zireael) written in C.
 
 **Links:** [Website](https://rezitui.dev/) · [Docs](https://rezitui.dev/) · [Quickstart](https://rezitui.dev/getting-started/quickstart/) · [Widgets](https://rezitui.dev/widgets/) · [Benchmarks](https://rezitui.dev/benchmarks/)
 
 ![Rezi command console demo](assets/REZICONSOLE3.gif)
 
 ## What Rezi Is For
 
-Rezi is aimed at terminal applications that need more than line-oriented output: multi-panel layouts, routed screens, focusable controls, forms, tables, overlays, testing support, and predictable behavior under keyboard and mouse input.
+Rezi is aimed at dashboards, control planes, internal tools, log viewers, and developer workflows that need more than line-oriented output: multi-panel layouts, routed screens, focusable controls, forms, tables, overlays, testing support, and predictable behavior under keyboard and mouse input.
 
 ## Why Rezi
 
-- Declarative application structure without requiring React
-- Deterministic render and input contracts for testable TUI workflows
+- Structured app model for real TUI workflows
+- Declarative widget API without requiring React
 - Native-backed framebuffer diffing and terminal output through Zireael
-- First-party widgets for real app surfaces: forms, tables, overlays, routing, charts, and command flows
-- Behavior-first test utilities for rendering, routing, focus, and terminal scenarios
+- First-party widgets for forms, tables, overlays, routing, charts, and command flows
+- Reproducible rendering and input contracts for behavior-first tests
 
 ## What Rezi Includes
 
 - Layout primitives for rows, columns, grids, panels, spacing, and layered screens
 - Interactive widgets such as buttons, inputs, selects, checkboxes, radios, sliders, tabs, tables, virtual lists, trees, dialogs, dropdowns, and toasts
 - Graphics and data-display widgets including canvas, charts, gauges, sparklines, heatmaps, and image support
 - Application primitives for focus management, keybindings, routing, theming, and controlled state updates
-- Testing utilities and deterministic rendering behavior intended to make TUI code easier to verify
+- Testing utilities for render assertions, routing and focus behavior, and replayable input workflows
 - A native-backed rendering path through Zireael for layout, framebuffer diffing, and terminal output
 
 ## Example
@@ -87,9 +87,9 @@ bun run start
 
 ## Public Templates
 
-- `minimal` - small single-screen starter
-- `cli-tool` - routed multi-screen workflow starter
-- `starship` - polished command-console showcase with routing, charts, canvas, forms, and overlays
+- `minimal` - small single-screen starter for focused utilities
+- `cli-tool` - routed multi-screen starter for product-style terminal tools
+- `starship` - larger command-console showcase with routing, charts, canvas, forms, and overlays
 
 ## Starship Demo
 

packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rezi-ui/core",
   "version": "0.1.0-alpha.61",
-  "description": "Runtime-agnostic TypeScript core for Rezi (widgets, layout, routing, drawlists, event parsing).",
+  "description": "Runtime-agnostic TypeScript core for building structured Rezi terminal applications.",
   "license": "Apache-2.0",
   "homepage": "https://rezitui.dev",
   "repository": {

packages/create-rezi/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-rezi",
   "version": "0.1.0-alpha.61",
-  "description": "Scaffold a Rezi terminal UI app.",
+  "description": "Scaffold a Rezi terminal application from focused starter and showcase templates.",
   "license": "Apache-2.0",
   "homepage": "https://rezitui.dev",
   "repository": {

packages/create-rezi/src/scaffold.ts

@@ -18,7 +18,7 @@ export const TEMPLATE_DEFINITIONS: readonly TemplateDefinition[] = [
   {
     key: "minimal",
     label: "Minimal Utility TUI",
-    description: "Single-screen starter for focused tools",
+    description: "Small single-screen starter for focused terminal utilities",
     safetyTag: "safe-default",
     safetyNote: "Small-footprint template for quick utility workflows.",
     highlights: [
@@ -30,7 +30,7 @@ export const TEMPLATE_DEFINITIONS: readonly TemplateDefinition[] = [
   {
     key: "cli-tool",
     label: "Multi-Screen CLI Tool",
-    description: "Multi-screen CLI starter with first-party routing",
+    description: "Routed starter for product-style terminal tools",
     safetyTag: "safe-default",
     safetyNote: "Lightweight template focused on product workflows and routing.",
     highlights: [
@@ -42,12 +42,12 @@ export const TEMPLATE_DEFINITIONS: readonly TemplateDefinition[] = [
   {
     key: "starship",
     label: "Starship Command Console",
-    description: "Polished multi-deck showcase for routing, animation, charts, forms, and overlays",
+    description: "Larger command-console showcase for routing, animation, charts, forms, and overlays",
     safetyTag: "safe-default",
     safetyNote:
       "Feature-rich showcase template with moderate CPU usage from animation hooks and live telemetry.",
     highlights: [
-      "six-screen bridge with routing, animated gauges, live telemetry charts, and crew management",
+      "six-screen command console with routing, animated gauges, live telemetry charts, and crew management",
       "command palette, modal dialogs, toast notifications, forms, split panes, canvas, and theme cycling with keybinding modes",
     ],
     dir: "starship",

packages/create-rezi/templates/starship/README.md

@@ -4,7 +4,7 @@ Scaffolded with `create-rezi` using the **__TEMPLATE_LABEL__** template.
 
 ## Concept
 
-`__APP_NAME__` is a multi-deck starship operations console. It demonstrates routed application architecture, deterministic telemetry simulation, rich widgets, layered overlays, and declarative animation hooks in a single advanced template.
+`__APP_NAME__` is a multi-deck starship operations console. It demonstrates routed application architecture, live telemetry simulation, rich widgets, layered overlays, and declarative animation hooks in a single advanced template.
 
 This template is intentionally larger than the default starters. Use it as a showcase, reference app, or screenshot target; use `minimal` or `cli-tool` when you want a smaller starting point.
 

packages/node/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rezi-ui/node",
   "version": "0.1.0-alpha.61",
-  "description": "Node.js/Bun backend for Rezi (worker-thread engine ownership, scheduling, IO).",
+  "description": "Node.js/Bun backend for running Rezi terminal applications with native engine integration.",
   "license": "Apache-2.0",
   "homepage": "https://rezitui.dev",
   "repository": {

packages/testkit/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rezi-ui/testkit",
   "version": "0.1.0-alpha.61",
-  "description": "Test utilities and fixtures for Rezi.",
+  "description": "Test utilities and fixtures for Rezi terminal applications.",
   "license": "Apache-2.0",
   "homepage": "https://rezitui.dev",
   "repository": {