@rootnative/cli 0.0.0-alpha.0

package/llms.txt

@@ -0,0 +1,105 @@
+# @rootnative/cli — CLI for RootNative UI
+
+> Version: 0.0.0-alpha.0
+> Binary: `rootnative`
+> Requirements: Node >=18
+
+## CLI (`rootnative`)
+
+### Commands
+
+#### `rootnative create [name]`
+
+Create a new project with RootNative UI pre-configured. Fetches the quickstart template, applies your project name to `package.json` and `app.json`, and optionally installs dependencies.
+
+```bash
+npx rootnative create            # Interactive
+npx rootnative create my-app     # With name
+npx rootnative create my-app -y  # Non-interactive, accept defaults
+```
+
+Options:
+- `-y, --yes` — Skip prompts and use defaults
+- `-t, --template <name>` — Template to use (`blank`, `with-router`)
+- `--package-manager <pm>` — Package manager to use (`npm`, `yarn`, `pnpm`, `bun`)
+
+#### `rootnative init`
+
+Copy-paste workflow — copies component source files into your project. The theme system (`@rootnative/core`) stays as an npm dependency.
+
+Initialize project. Detects project type (Expo/RN), package manager, and tsconfig path aliases.
+
+```bash
+npx rootnative init            # Interactive
+npx rootnative init -y         # Non-interactive, accept defaults
+npx rootnative init -y --components-alias "~/ui" --lib-alias "~/utils"
+```
+
+Options:
+- `-y, --yes` — Skip all prompts, use detected defaults. Overwrites existing config. Auto-installs `@rootnative/core`.
+- `--components-alias <alias>` — Components install path. Default: `@/components/ui` (or `~/components/ui` if `~/*` alias detected in tsconfig)
+- `--lib-alias <alias>` — Utility files path. Default: `@/lib` (or `~/lib` if `~/*` alias detected)
+- `--package-manager <pm>` — Package manager to use (`npm`, `yarn`, `pnpm`, `bun`)
+
+Creates `rootnative.json`:
+```json
+{
+  "$schema": "https://rootnative.github.io/ui/schema.json",
+  "aliases": { "components": "@/components/ui", "lib": "@/lib" },
+  "registryUrl": "https://raw.githubusercontent.com/rootnative/ui",
+  "registryVersion": "main"
+}
+```
+
+#### `rootnative add <components...>`
+
+Add components to your project. Resolves dependency graph, copies files with rewritten imports, installs npm deps.
+
+```bash
+npx rootnative add button
+npx rootnative add card chip text-field
+npx rootnative add appbar      # auto-adds icon-button + typography
+```
+
+Options:
+- `-f, --force` — Overwrite existing components
+- `-d, --dry-run` — Preview without writing files
+- `--package-manager <pm>` — Package manager to use (`npm`, `yarn`, `pnpm`, `bun`)
+
+#### `rootnative update [components...]`
+
+Update installed components to latest registry version.
+
+Options:
+- `-a, --all` — Update all installed components
+- `-d, --dry-run` — Show diff without applying
+
+#### `rootnative upgrade`
+
+Upgrade `@rootnative/core` to the latest published version and install any new peer dependencies.
+
+```bash
+npx rootnative upgrade         # Interactive — shows plan and prompts before installing
+npx rootnative upgrade -y      # Non-interactive — skip confirmation
+```
+
+Options:
+- `-y, --yes` — Skip confirmation prompt
+- `--package-manager <pm>` — Package manager to use (`npm`, `yarn`, `pnpm`, `bun`)
+
+What it does:
+1. Reads the installed `@rootnative/core` version from `node_modules`
+2. Fetches the latest version from the npm registry
+3. Compares peer dependencies between the installed and latest versions
+4. Shows a plan: version bump, new required peer deps, changed version ranges, removed deps
+5. Upgrades `@rootnative/core` and installs any new required peer dependencies in one step
+6. Reports optional peer deps that aren't installed (does not auto-install optional deps)
+7. Lists peer deps that are no longer required so you can remove them manually
+
+#### `rootnative list`
+
+Show available components with install status.
+
+#### `rootnative doctor`
+
+Check project health: config validity, core installation, RN version, file integrity, peer deps.

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@rootnative/cli",
+  "version": "0.0.0-alpha.0",
+  "description": "CLI for adding RootNative UI components to your React Native project",
+  "private": false,
+  "bin": {
+    "rootnative": "dist/index.mjs"
+  },
+  "exports": "./dist/index.mjs",
+  "files": [
+    "dist",
+    "llms.txt"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rootnative/ui.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/rootnative/ui",
+  "keywords": [
+    "react-native",
+    "material-design-3",
+    "ui",
+    "cli",
+    "components",
+    "rootnative"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "execa": "^9.5.2",
+    "fs-extra": "^11.3.0",
+    "ora": "^8.2.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint . --max-warnings 0"
+  }
+}