@docyrus/cli 0.1.0 → 0.2.0

package/README.md

@@ -2,78 +2,86 @@
 
 Official command-line interface for Docyrus - authentication, project scaffolding, and code generation tools.
 
-## Installation
+## Usage
 
 ```bash
-npm install -g docyrus
-# or
-pnpm add -g docyrus
+npx @docyrus/cli <command>
 ```
 
 ## Commands
 
 ### Authentication
 
-#### `docyrus login`
+#### `login`
 
 Log in to Docyrus using browser-based SSO (default).
 
 ```bash
-docyrus login              # Opens browser for SSO authentication
-docyrus login --email      # Use email/password instead (prompts for credentials)
-docyrus login -e user@example.com  # Pre-fill email address
+npx @docyrus/cli login              # Opens browser for SSO authentication
+npx @docyrus/cli login --email      # Use email/password instead (prompts for credentials)
+npx @docyrus/cli login -e user@example.com  # Pre-fill email address
 ```
 
-#### `docyrus logout`
+#### `logout`
 
 Log out from Docyrus and clear stored credentials.
 
 ```bash
-docyrus logout
+npx @docyrus/cli logout
 ```
 
-#### `docyrus whoami`
+#### `whoami`
 
 Display the currently logged-in user.
 
 ```bash
-docyrus whoami
+npx @docyrus/cli whoami
 # Output: Email: user@example.com
 #         Name: John Doe
 ```
 
 ### Project Creation
 
-#### `docyrus create [name]`
+#### `create [name]`
 
 Create a new Docyrus project from a template.
 
 ```bash
-docyrus create                           # Interactive mode - prompts for all options
-docyrus create my-app                    # Create project with specified name
-docyrus create my-app --nextjs           # Next.js + plain Tailwind
-docyrus create my-app --nextjs --shadcn  # Next.js + shadcn/ui
-docyrus create my-app --react --heroui   # React + HeroUI
-docyrus create my-app --vue --shadcn     # Vue + shadcn-vue
-docyrus create my-app --astro            # Astro + plain Tailwind
-docyrus create my-app --nextjs --shadcn --eslint --pnpm  # Full flags
+npx @docyrus/cli create                           # Interactive mode - prompts for all options
+npx @docyrus/cli create my-app                    # Create project with specified name
+npx @docyrus/cli create my-app --nextjs           # Next.js + plain Tailwind
+npx @docyrus/cli create my-app --nextjs --shadcn  # Next.js + shadcn/ui
+npx @docyrus/cli create my-app --react --heroui   # React + HeroUI
+npx @docyrus/cli create my-app --react --diceui   # React + DiceUI
+npx @docyrus/cli create my-app --vue --shadcn     # Vue + shadcn-vue
+npx @docyrus/cli create my-app --electron --shadcn # Electron + shadcn/ui
+npx @docyrus/cli create my-app --nextjs --shadcn --zustand --eslint --pnpm  # Full flags
 ```
 
 **Framework Options:**
 
 | Flag | Description |
 |------|-------------|
-| `--nextjs` | Use Next.js 15+ (App Router) |
+| `--nextjs` | Use Next.js 16+ (App Router) |
 | `--react` | Use React 19+ with Vite |
-| `--astro` | Use Astro 5+ |
 | `--vue` | Use Vue 3.5+ with Vite |
+| `--electron` | Use Electron + React + Vite |
 
 **UI Library Options (optional - defaults to plain Tailwind if not specified):**
 
-| Flag | Description |
-|------|-------------|
-| `--shadcn` | Use shadcn/ui (React/Next.js) or shadcn-vue (Vue) |
-| `--heroui` | Use HeroUI (React/Next.js only) |
+| Flag | Compatible Frameworks |
+|------|----------------------|
+| `--shadcn` | Next.js, React, Electron (shadcn/ui) / Vue (shadcn-vue) |
+| `--diceui` | Next.js, React, Electron |
+| `--heroui` | Next.js, React |
+
+**State Management Options (optional):**
+
+| Flag | Compatible Frameworks |
+|------|----------------------|
+| `--zustand` | Next.js, React, Electron |
+| `--tanstack-query` | Next.js, React, Electron |
+| `--tanstack-vue-query` | Vue |
 
 **Linter Options:**
 
@@ -98,37 +106,24 @@ docyrus create my-app --nextjs --shadcn --eslint --pnpm  # Full flags
 |--------|-------------|
 | `-p, --path <path>` | Target directory path |
 | `--alias <prefix>` | Custom import alias prefix (must start with @) |
-
-**Available Templates:**
-
-| Template | Description |
-|----------|-------------|
-| `nextjs` | Next.js 15+ + Tailwind CSS v4 |
-| `nextjs-shadcn` | Next.js 15+ + Tailwind CSS v4 + shadcn/ui |
-| `nextjs-heroui` | Next.js 15+ + Tailwind CSS v4 + HeroUI |
-| `react` | React 19+ + Vite + Tailwind CSS v4 |
-| `react-shadcn` | React 19+ + Vite + Tailwind CSS v4 + shadcn/ui |
-| `react-heroui` | React 19+ + Vite + Tailwind CSS v4 + HeroUI |
-| `astro` | Astro 5+ + Tailwind CSS v4 |
-| `vue` | Vue 3.5+ + Vite + Tailwind CSS v4 |
-| `vue-shadcn` | Vue 3.5+ + Vite + Tailwind CSS v4 + shadcn-vue |
+| `--local` | Use local templates (development only) |
 
 Each template includes:
-- Pre-configured OAuth2 authentication pages
+- Pre-configured OAuth2 authentication via `@docyrus/app-auth-ui`
 - Docyrus API client integration
 - Modern TypeScript setup
 - Linter configuration (ESLint or Biome)
 
 ### Code Generation
 
-#### `docyrus generate db [spec]`
+#### `generate db [spec]`
 
 Generate TanStack Query collections from an OpenAPI 3.1.0 specification.
 
 ```bash
-docyrus generate db                           # Auto-detect openapi.json in current directory
-docyrus generate db ./api/openapi.json        # Specify spec file path
-docyrus generate db ./spec.json -o ./src/api  # Custom output directory
+npx @docyrus/cli generate db                           # Auto-detect openapi.json in current directory
+npx @docyrus/cli generate db ./api/openapi.json        # Specify spec file path
+npx @docyrus/cli generate db ./spec.json -o ./src/api  # Custom output directory
 ```
 
 **Options:**
@@ -136,53 +131,23 @@ docyrus generate db ./spec.json -o ./src/api  # Custom output directory
 | Option | Description |
 |--------|-------------|
 | `-o, --output <dir>` | Output directory (defaults to `src` in spec file folder) |
-| `-w, --watch` | Watch for changes in the spec file (coming soon) |
 
 ### CLI Management
 
-#### `docyrus upgrade`
+#### `upgrade`
 
 Upgrade the CLI to the latest version. Automatically detects your package manager (npm, pnpm, yarn, bun).
 
 ```bash
-docyrus upgrade
+npx @docyrus/cli upgrade
 ```
 
-#### `docyrus completion <shell>`
+#### `info`
 
-Generate shell completion script for tab completion support.
+Display CLI version, system information, and authentication status.
 
 ```bash
-# Bash - add to ~/.bashrc
-eval "$(docyrus completion bash)"
-
-# Zsh - add to ~/.zshrc
-eval "$(docyrus completion zsh)"
-
-# Fish - save to completions directory
-docyrus completion fish > ~/.config/fish/completions/docyrus.fish
-```
-
-#### `docyrus info`
-
-Display CLI version, system information, and authentication status. Useful for debugging.
-
-```bash
-docyrus info
-# Output:
-# docyrus v0.0.1
-#
-# System:
-#   Node.js:  v20.10.0
-#   OS:       darwin 23.0.0 (arm64)
-#
-# Environment:
-#   API URL:  https://api.docyrus.com
-#   Config:   /Users/you/.docyrus
-#
-# Authentication:
-#   Status:   Logged in
-#   Email:    user@example.com
+npx @docyrus/cli info
 ```
 
 ## Global Options
@@ -192,42 +157,21 @@ docyrus info
 Output results in JSON format. Useful for scripting and CI/CD pipelines.
 
 ```bash
-docyrus whoami --json
-# Output: {"user": {"email": "user@example.com", "firstname": "John", "lastname": "Doe"}}
-
-docyrus generate db ./spec.json --json
-# Output: {"spec": "./spec.json", "output": "./src", "success": true, "message": "..."}
+npx @docyrus/cli whoami --json
+npx @docyrus/cli generate db ./spec.json --json
 ```
 
 ### `-v, --version`
 
 Display the CLI version.
 
-```bash
-docyrus -v
-# Output: 0.0.1
-```
-
 ### `-h, --help`
 
 Display help information.
 
 ```bash
-docyrus --help
-docyrus login --help
-docyrus generate --help
-docyrus generate db --help
-```
-
-## Auto-Update Notifications
-
-The CLI automatically checks for updates and displays a notification when a new version is available:
-
-```
-┌────────────────────────────────────────────┐
-│  Update available! 0.0.1 → 0.1.0           │
-│  Run npm i -g docyrus to update            │
-└────────────────────────────────────────────┘
+npx @docyrus/cli --help
+npx @docyrus/cli create --help
 ```
 
 ## Environment Variables
@@ -236,7 +180,7 @@ The CLI automatically checks for updates and displays a notification when a new
 |----------|-------------|
 | `DOCYRUS_API_URL` | Override the API base URL |
 | `DOCYRUS_OAUTH_CLIENT_ID` | Override the OAuth2 client ID |
-| `DEBUG` | Enable debug output |
+| `DOCYRUS_OAUTH_SCOPES` | Override the OAuth2 scopes |
 
 ## Token Storage
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Docyrus/docyrus-devkit.git",
@@ -39,8 +39,8 @@
     "keytar": "7.9.0",
     "open": "11.0.0",
     "ora": "9.3.0",
-    "@docyrus/tanstack-db-generator": "0.4.1",
-    "@docyrus/api-client": "0.0.8"
+    "@docyrus/api-client": "0.0.8",
+    "@docyrus/tanstack-db-generator": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "25.2.2",