@oaysus/cli 0.1.16 → 0.1.17

package/docs/theme-commands.md

@@ -0,0 +1,259 @@
+# Theme Pack Commands
+
+Theme packs are collections of reusable components that can be installed on any Oaysus website.
+
+## oaysus theme init
+
+Create a new theme pack project.
+
+```bash
+oaysus theme init [name]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[name]` | Optional project name (prompted if not provided) |
+
+### Example
+
+```bash
+oaysus theme init marketing-starter
+```
+
+### Output
+
+```
+? Select framework: React
+? Project name: marketing-starter
+? Description: Landing page components
+? Author: Your Name
+? Create project? Yes
+
+✓ Created package.json
+✓ Created components/
+✓ Created shared/
+✓ Added Hero component
+✓ Project ready!
+```
+
+### Generated Files
+
+- `package.json` - Project configuration with Oaysus metadata
+- `components/` - Directory for your components
+- `components/Hero/` - Example component with schema
+- `shared/` - Directory for shared utilities
+
+---
+
+## oaysus theme create
+
+Add a new component to an existing theme pack.
+
+```bash
+oaysus theme create [name] [path]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[name]` | Component name (converted to PascalCase) |
+| `[path]` | Optional path to theme pack directory |
+
+### Example
+
+```bash
+oaysus theme create FeatureGrid
+```
+
+### Output
+
+```
+? Component name: FeatureGrid
+? Description: Feature grid component
+? Category: marketing
+? Create component? Yes
+
+✓ Created components/FeatureGrid/index.tsx
+✓ Created components/FeatureGrid/schema.json
+```
+
+---
+
+## oaysus theme validate
+
+Check your theme pack for errors before pushing.
+
+```bash
+oaysus theme validate [path]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[path]` | Optional path to theme pack directory |
+| `--dry-run` | Validate without creating build artifacts |
+
+### Example
+
+```bash
+oaysus theme validate
+```
+
+### Output
+
+```
+Validating package...
+✓ package.json valid
+✓ components/ directory found
+✓ 3 components discovered
+✓ All schemas valid
+
+Ready to push!
+```
+
+### Common Errors
+
+- **Missing package.json** - Run from a theme pack directory
+- **Invalid schema** - Check JSON syntax in schema.json files
+- **Missing component file** - Each component needs index.tsx/vue/svelte
+
+---
+
+## oaysus theme build
+
+Build components locally without uploading.
+
+```bash
+oaysus theme build [path]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[path]` | Optional path to theme pack directory |
+
+### Example
+
+```bash
+oaysus theme build
+```
+
+### Output
+
+```
+Building components...
+✓ Validated package
+✓ Built client components
+✓ Built server components
+✓ Bundled dependencies
+✓ Generated import map
+
+Build complete → .oaysus-build/
+```
+
+### Build Output
+
+The `.oaysus-build/` directory contains:
+- Compiled client-side components
+- Server-side rendered versions
+- Dependency bundle
+- Import map for the runtime
+
+---
+
+## oaysus theme push
+
+Build and upload components to Oaysus.
+
+```bash
+oaysus theme push [path]
+```
+
+**Requires authentication.**
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[path]` | Optional path to theme pack directory |
+
+### Example
+
+```bash
+oaysus theme push
+```
+
+### Output
+
+```
+Authenticating...
+✓ Authenticated
+
+Building components...
+✓ Validated package
+✓ Built client components
+✓ Built server components
+✓ Bundled dependencies
+✓ Generated manifest
+
+Uploading to Oaysus...
+████████████████████ 100%
+
+✓ Upload complete
+✓ Theme Pack ID: abc123
+✓ 3 components published
+
+Install in dashboard: Content → Theme Packs
+```
+
+### After Pushing
+
+1. Open your Oaysus dashboard
+2. Go to Content → Theme Packs
+3. Click Install on your theme pack
+4. Components appear in the page builder
+
+---
+
+## oaysus theme delete
+
+Delete a theme pack from Oaysus.
+
+```bash
+oaysus theme delete [name]
+```
+
+**Requires authentication.**
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `[name]` | Theme pack name to delete |
+
+### Example
+
+```bash
+oaysus theme delete my-old-theme
+```
+
+### Output
+
+```
+? Select theme pack to delete:
+❯ my-old-theme (v1.2.0)
+  another-theme (v2.0.0)
+
+? Are you sure you want to delete "my-old-theme"? Yes
+
+✓ Theme pack deleted
+```
+
+### Warning
+
+Deleting a theme pack removes all components. Pages using these components will need to be updated.

package/llms.txt

@@ -0,0 +1,94 @@
+# Oaysus CLI
+
+> Command-line tool for building and pushing components to the Oaysus visual page builder platform. Supports React, Vue, and Svelte.
+
+The Oaysus CLI enables developers to create reusable UI components, bundle them into theme packs, and push them to the cloud where marketing teams can use them in a visual page builder. It also supports local page management for version control and AI-assisted content workflows.
+
+## Documentation
+
+- [Getting Started](./docs/getting-started.md): Installation and quick start guide
+- [Theme Pack Commands](./docs/theme-commands.md): Building and managing component libraries
+- [Site Commands](./docs/site-commands.md): Managing website pages locally
+- [Component Guide](./docs/components.md): Building components in React, Vue, and Svelte
+- [Schema Reference](./docs/schemas.md): Complete prop type reference
+- [AI Workflows](./docs/ai-workflows.md): Using CLI with AI assistants for bulk content editing
+
+## Installation
+
+```bash
+npm install -g @oaysus/cli
+```
+
+Requires Node.js 20 or higher.
+
+## Quick Start
+
+```bash
+oaysus login                    # Authenticate with your account
+oaysus theme init my-components # Create a new theme pack
+cd my-components
+oaysus theme push               # Push components to Oaysus
+```
+
+## Command Reference
+
+### Theme Pack Commands
+
+- `oaysus theme init [name]` - Create a new theme pack project with React, Vue, or Svelte
+- `oaysus theme create [name]` - Add a new component to your theme pack
+- `oaysus theme validate` - Validate theme pack structure and schemas
+- `oaysus theme build` - Build components locally without uploading
+- `oaysus theme push` - Build and upload components to Oaysus
+- `oaysus theme delete [name]` - Delete a theme pack from Oaysus
+
+### Site Commands
+
+- `oaysus site init [name]` - Create a website project for local page management
+- `oaysus site validate` - Validate pages against installed components
+- `oaysus site publish [file?]` - Publish pages from local JSON files
+- `oaysus site pull` - Download pages from server to local files
+
+### Global Commands
+
+- `oaysus login` - Authenticate via magic link
+- `oaysus switch` - Switch between your websites
+- `oaysus logout` - Clear stored credentials
+- `oaysus whoami` - Show current user and session info
+- `oaysus telemetry status|enable|disable` - Manage anonymous usage analytics
+
+## Component Structure
+
+Each component requires two files:
+
+```
+components/
+└── Hero/
+    ├── index.tsx     # Component code (React/Vue/Svelte)
+    └── schema.json   # Editable props definition
+```
+
+## Schema Types
+
+- `string` - Single line text input
+- `text` - Multi-line textarea
+- `number` - Numeric value with optional min/max/step
+- `boolean` - True/false toggle
+- `color` - Hex color picker
+- `image` - Image from media library
+- `array` - Repeatable list of items
+- `select` - Dropdown with options
+
+## Framework Support
+
+- React (JSX/TSX with hooks)
+- Vue 3 (Single File Components)
+- Svelte (native .svelte files)
+
+Framework is auto-detected from package.json dependencies.
+
+## Optional
+
+- [Contributing](./CONTRIBUTING.md): Development setup and contribution guidelines
+- [GitHub Repository](https://github.com/oaysus/cli): Source code and issues
+- [npm Package](https://www.npmjs.com/package/@oaysus/cli): Published package
+- [Full Documentation](https://oaysus.com/docs): Complete platform documentation

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oaysus/cli",
-  "version": "0.1.16",
-  "description": "Oaysus CLI - Professional developer tool for component uploads",
+  "version": "0.1.17",
+  "description": "Build React, Vue, or Svelte components and push them to a visual page builder. Empower marketing teams to create pages without code.",
   "type": "module",
   "bin": {
     "oaysus": "./bin/oaysus.js"
@@ -11,7 +11,9 @@
   "files": [
     "dist",
     "bin",
-    "src/templates"
+    "docs",
+    "src/templates",
+    "llms.txt"
   ],
   "scripts": {
     "build": "tsc",
@@ -84,7 +86,21 @@
     "oaysus",
     "cli",
     "components",
-    "developer-tools"
+    "developer-tools",
+    "page-builder",
+    "visual-editor",
+    "cms",
+    "headless-cms",
+    "react-components",
+    "vue-components",
+    "svelte-components",
+    "landing-pages",
+    "marketing-pages",
+    "no-code",
+    "low-code",
+    "theme-pack",
+    "component-library",
+    "website-builder"
   ],
   "author": "Oaysus Team",
   "license": "MIT",