@elsapiens/cli 0.1.0

package/README.md

@@ -0,0 +1,283 @@
+# @elsapiens/cli
+
+CLI scaffolding tool for creating and managing elSapiens SDK projects.
+
+## Installation
+
+```bash
+# Use directly with npx (recommended)
+npx @elsapiens/cli init my-app
+
+# Or install globally
+npm install -g @elsapiens/cli
+```
+
+## Features
+
+- Create new projects with elSapiens SDK
+- Add pages with correct structure and patterns
+- Add components with TypeScript templates
+- Interactive prompts for configuration
+- Cross-platform support (macOS, Linux, Windows)
+
+## Commands
+
+### Create New Project
+
+```bash
+# Interactive mode
+el init my-app
+
+# With template selection
+el init my-app --template minimal
+el init my-app --template full
+
+# Skip prompts
+el init my-app --yes
+
+# Skip git initialization
+el init my-app --no-git
+```
+
+**Templates:**
+
+| Template | Description |
+|----------|-------------|
+| `minimal` | Basic setup with single Dashboard page |
+| `full` | Complete setup with Dashboard, Settings, and examples |
+
+**Generated Structure (minimal):**
+
+```
+my-app/
+├── package.json
+├── vite.config.ts
+├── tsconfig.json
+├── index.html
+├── .gitignore
+└── src/
+    ├── main.tsx
+    ├── App.tsx
+    ├── index.css
+    └── pages/
+        └── Dashboard.tsx
+```
+
+### Add Page
+
+```bash
+# Interactive mode
+el add page
+
+# With name
+el add page Users
+
+# With template
+el add page Users --template list
+el add page Dashboard --template dashboard
+el add page Settings --template settings
+
+# Custom path
+el add page Users --path src/features/users/pages
+```
+
+**Page Templates:**
+
+| Template | Description |
+|----------|-------------|
+| `dashboard` | Overview page with stats, charts, and activity table |
+| `list` | Data listing with search, filters, and table |
+| `settings` | Configuration page with form sections and toggles |
+
+**Page Structure:**
+
+All pages follow the established alignment pattern:
+
+```tsx
+<div className="p-6">
+  {/* Page Header - pl-6 to align with table spacer */}
+  <div className="flex items-center justify-between mb-8 pl-6">
+    <div>
+      <h1 className="text-2xl font-bold text-foreground">Title</h1>
+      <p className="text-muted-foreground">Description</p>
+    </div>
+    {/* Actions */}
+  </div>
+
+  {/* Content with Cards */}
+  <Card padding="none">
+    <CardHeader className="p-6">
+      <CardTitle>Section</CardTitle>
+    </CardHeader>
+    <CardContent className="p-6 pt-0">
+      {/* Content */}
+    </CardContent>
+  </Card>
+</div>
+```
+
+### Add Component
+
+```bash
+# Interactive mode
+el add component
+
+# With name
+el add component UserCard
+
+# With template
+el add component UserCard --template simple
+el add component DataTable --template stateful
+
+# Custom path
+el add component UserCard --path src/features/users/components
+```
+
+**Component Templates:**
+
+| Template | Description |
+|----------|-------------|
+| `simple` | Basic component with props and className |
+| `stateful` | Component with useState and onChange callback |
+
+## Usage Examples
+
+### Creating a New Project
+
+```bash
+$ el init my-dashboard
+
+  elSapiens CLI v0.1.0
+
+? Project name: my-dashboard
+? Select template: Minimal
+? Initialize git repository? Yes
+
+Creating project...
+  ✓ package.json
+  ✓ vite.config.ts
+  ✓ tsconfig.json
+  ✓ src/main.tsx
+  ✓ src/App.tsx
+  ✓ src/pages/Dashboard.tsx
+
+Done! Run:
+  cd my-dashboard
+  pnpm install
+  pnpm dev
+```
+
+### Adding a Page
+
+```bash
+$ el add page Users --template list
+
+  Add Page
+
+? Page title: Users
+? Description: Manage user accounts
+
+  ✓ Created src/pages/Users.tsx
+
+Add route to App.tsx:
+  import Users from './pages/Users';
+  <Route path="/users" element={<Users />} />
+```
+
+### Adding a Component
+
+```bash
+$ el add component UserCard --template stateful
+
+  Add Component
+
+  ✓ Created src/components/UserCard.tsx
+
+Import and use:
+  import { UserCard } from './components/UserCard';
+  <UserCard className="..." />
+```
+
+## CLI Reference
+
+### `el init [project-name]`
+
+Create a new elSapiens project.
+
+| Option | Description |
+|--------|-------------|
+| `-t, --template <type>` | Project template (minimal, full) |
+| `--no-git` | Skip git initialization |
+| `-y, --yes` | Skip prompts, use defaults |
+
+### `el add page [name]`
+
+Add a new page to the project.
+
+| Option | Description |
+|--------|-------------|
+| `-t, --template <type>` | Page template (dashboard, list, settings) |
+| `-p, --path <dir>` | Custom pages directory |
+
+### `el add component [name]`
+
+Add a new component to the project.
+
+| Option | Description |
+|--------|-------------|
+| `-t, --template <type>` | Component template (simple, stateful) |
+| `-p, --path <dir>` | Custom components directory |
+
+## Aliases
+
+The CLI supports multiple command aliases:
+
+```bash
+# These are equivalent
+el init my-app
+elsapiens init my-app
+
+# Add command aliases
+el add page Users
+el generate page Users
+el g page Users
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- npm, pnpm, or yarn
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/elsapiens/sdk.git
+cd sdk/packages/cli
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Test locally
+node dist/index.js --help
+node dist/index.js init test-app
+
+# Link globally for testing
+pnpm link --global
+el --version
+```
+
+## Publishing
+
+```bash
+# Build and publish
+pnpm build
+npm publish --access public
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }