create-nexo 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Shaban
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+<div align="center">
+
+# 🚀 NEXO CLI
+
+**Next-generation scaffolding CLI for modern React projects**
+
+[![npm version](https://img.shields.io/npm/v/nexo-cli.svg?style=flat-square)](https://www.npmjs.com/package/nexo-cli)
+[![npm downloads](https://img.shields.io/npm/dm/nexo-cli.svg?style=flat-square)](https://www.npmjs.com/package/nexo-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-24+-green.svg?style=flat-square)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7+-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
+
+[Features](#-features) • [Quick Start](#-quick-start) • [Options](#-options) • [Documentation](#-documentation)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 🎯 **Interactive CLI** — Guided project setup with smart defaults
+- 📝 **TypeScript First** — Full type safety out of the box
+- ⚡ **Vite Powered** — Lightning-fast development and builds
+- 🔮 **Next.js Support** — Coming Soon!
+- 🎨 **Modern Styling** — Tailwind CSS v4, CSS Modules, Sass
+- 🧩 **UI Libraries** — shadcn/ui, Radix, Mantine, HeroUI
+- 📋 **Forms** — React Hook Form + Zod/Yup, Formik
+- 🗃️ **State Management** — Zustand, Redux Toolkit, Jotai
+- 🛣️ **Routing** — React Router, TanStack Router
+- 🔄 **Data Fetching** — TanStack Query, Axios
+- 🌍 **i18n** — i18next, Lingui
+- 🔐 **Auth Templates** — JWT, Auth.js patterns
+- 🔧 **CI/CD** — GitHub Actions workflow included
+- 📁 **Project Structures** — Feature-based, FSD, Atomic, Clean Architecture
+
+---
+
+## 📦 Quick Start
+
+```bash
+# Recommended (no install needed)
+npm create nexo
+
+# Or with other package managers
+pnpm create nexo
+yarn create nexo
+
+# Or install globally
+npm install -g create-nexo
+nexo create my-app
+```
+
+### Wizard Mode (for beginners)
+
+```bash
+npm create nexo wizard
+```
+
+---
+
+## 🎯 Usage
+
+### Create a new project
+
+```bash
+nexo create my-app
+```
+
+### With options
+
+```bash
+# With CI/CD
+nexo create my-app --cicd
+
+# Faster with parallel execution
+nexo create my-app --parallel
+
+# Preview only (dry run)
+nexo create my-app --dry-run
+
+# Use a preset
+nexo create my-app --preset=saas
+```
+
+### Generate components
+
+```bash
+# Generate a component
+nexo gc Button
+
+# With tests and styles
+nexo gc Button --with-tests --with-styles
+
+# Generate a hook
+nexo gh useAuth
+
+# Generate a feature (FSD style)
+nexo generate feature auth
+```
+
+---
+
+## 🎨 Options
+
+### Build Variants
+
+| Option | Description |
+|--------|-------------|
+| TypeScript + React Compiler ⭐ | Auto-optimization with React 19 |
+| TypeScript ⭐ | Standard TypeScript |
+| TypeScript + SWC | 20x faster builds |
+| JavaScript | No type system |
+
+### Styling
+
+| Option | Description |
+|--------|-------------|
+| Tailwind CSS ⭐ | Utility-first CSS framework |
+| CSS Modules | Scoped CSS by default |
+| Sass/SCSS | CSS with superpowers |
+| Plain CSS | Standard CSS files |
+
+### UI Libraries
+
+| Option | Description |
+|--------|-------------|
+| shadcn/ui ⭐ | Beautiful copy-paste components |
+| Radix UI | Unstyled, accessible primitives |
+| Mantine | 100+ customizable components |
+| HeroUI | Modern Tailwind-based UI |
+
+### State Management
+
+| Option | Description |
+|--------|-------------|
+| Zustand ⭐ | Small, fast, scalable |
+| Redux Toolkit | Industry standard |
+| Jotai | Atomic state management |
+
+### Project Structures
+
+| Option | Description |
+|--------|-------------|
+| Feature-based ⭐ | Organize by features/domain |
+| FSD ⭐ | Feature-Sliced Design |
+| Atomic Design | Atoms → Molecules → Organisms |
+| Clean Architecture | Domain-driven layers |
+| Simple | Minimal structure |
+
+⭐ = Recommended
+
+---
+
+## 📚 Documentation
+
+- [API Reference](./docs/api.md)
+- [CLI Commands](./docs/cli.md)
+
+---
+
+## 🔧 Development
+
+```bash
+git clone https://github.com/YOUR_USERNAME/nexo-cli.git
+cd nexo-cli
+npm install
+npm run build
+node dist/bin/nexo.js
+```
+
+---
+
+## 📄 License
+
+MIT © 2026
+
+---
+
+<div align="center">
+
+**Built with ❤️ for the modern web**
+
+[Report Bug](https://github.com/Moshaban09/create-nexo/issues) • [Request Feature](https://github.com/Moshaban09/create-nexo/issues)
+
+</div>

package/dist/api/index.d.ts

@@ -0,0 +1,196 @@
+/**
+ * NEXO CLI - Programmatic API
+ *
+ * Allows programmatic usage of NEXO for tooling integration,
+ * scripts, and automated project creation.
+ *
+ * @example
+ * ```typescript
+ * import { nexo } from 'nexo-cli';
+ *
+ * const result = await nexo.create({
+ *   projectName: 'my-app',
+ *   targetDir: './projects',
+ *   selections: {
+ *     variant: 'ts',
+ *     styling: 'tailwind',
+ *     ui: 'shadcn'
+ *   }
+ * });
+ * ```
+ */
+import type { UserSelections } from '../types/index.js';
+import { validateProjectName, type ValidationResult } from '../validation/index.js';
+/**
+ * Options for creating a new project
+ */
+export interface CreateOptions {
+    /** Name of the project (kebab-case recommended) */
+    projectName: string;
+    /** Directory to create the project in */
+    targetDir: string;
+    /** User selections for project configuration */
+    selections: Partial<UserSelections>;
+    /** If true, shows what would be created without creating files */
+    dryRun?: boolean;
+    /** If true, suppresses console output */
+    silent?: boolean;
+    /** If true, uses parallel execution for better performance */
+    parallel?: boolean;
+    /** If true, overwrites existing directory */
+    force?: boolean;
+}
+/**
+ * Result of a project creation
+ */
+export interface CreateResult {
+    /** Whether the creation was successful */
+    success: boolean;
+    /** Full path to the created project */
+    projectPath: string;
+    /** Duration of the creation in milliseconds */
+    duration: number;
+    /** List of created files (if available) */
+    files: string[];
+    /** Error messages if creation failed */
+    errors: string[];
+    /** Warning messages */
+    warnings: string[];
+    /** Whether this was a dry run */
+    dryRun: boolean;
+}
+/**
+ * Options for previewing a project
+ */
+export interface PreviewOptions {
+    /** User selections for project configuration */
+    selections: Partial<UserSelections>;
+    /** Project name (for file tree generation) */
+    projectName?: string;
+}
+/**
+ * Result of a project preview
+ */
+export interface PreviewResult {
+    /** ASCII file tree representation */
+    fileTree: string;
+    /** List of dependencies that would be installed */
+    dependencies: DependencyInfo[];
+    /** Validation result */
+    validation: ValidationResult;
+    /** Estimated files count */
+    estimatedFileCount: number;
+}
+/**
+ * Dependency information
+ */
+export interface DependencyInfo {
+    name: string;
+    version: string;
+    isDev: boolean;
+    reason: string;
+}
+/**
+ * Create a new NEXO project
+ *
+ * @param options - Configuration options for the project
+ * @returns Promise<CreateResult> - Result of the creation operation
+ *
+ * @example
+ * ```typescript
+ * const result = await create({
+ *   projectName: 'my-app',
+ *   targetDir: './projects',
+ *   selections: {
+ *     variant: 'ts',
+ *     styling: 'tailwind',
+ *     ui: 'shadcn'
+ *   }
+ * });
+ *
+ * if (result.success) {
+ *   console.log(`Created at: ${result.projectPath}`);
+ * }
+ * ```
+ */
+export declare const create: (options: CreateOptions) => Promise<CreateResult>;
+/**
+ * Validate project selections before creation
+ *
+ * @param selections - User selections to validate
+ * @returns ValidationResult - Validation result with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const result = validate({
+ *   ui: 'shadcn',
+ *   styling: 'plain-css' // Error: shadcn requires tailwind
+ * });
+ *
+ * if (!result.valid) {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export declare const validate: (selections: Partial<UserSelections>) => ValidationResult;
+/**
+ * Preview what would be created without actually creating files
+ *
+ * @param options - Preview options
+ * @returns PreviewResult - Preview information including file tree and dependencies
+ *
+ * @example
+ * ```typescript
+ * const preview = await nexo.preview({
+ *   selections: {
+ *     variant: 'ts',
+ *     styling: 'tailwind',
+ *     ui: 'shadcn'
+ *   }
+ * });
+ *
+ * console.log(preview.fileTree);
+ * console.log(`Dependencies: ${preview.dependencies.length}`);
+ * ```
+ */
+export declare const preview: (options: PreviewOptions) => Promise<PreviewResult>;
+/**
+ * Validate a project name
+ *
+ * @param name - Project name to validate
+ * @returns ValidationResult - Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = nexo.validateProjectName('my-app');
+ * if (result.valid) {
+ *   console.log('Valid project name!');
+ * }
+ * ```
+ */
+export { validateProjectName };
+/**
+ * NEXO CLI API namespace
+ *
+ * @example
+ * ```typescript
+ * import { nexo } from 'nexo-cli';
+ *
+ * // Create a project
+ * const result = await nexo.create({ ... });
+ *
+ * // Validate selections
+ * const validation = nexo.validate({ ... });
+ *
+ * // Preview what would be created
+ * const preview = await nexo.preview({ ... });
+ * ```
+ */
+export declare const nexo: {
+    create: (options: CreateOptions) => Promise<CreateResult>;
+    validate: (selections: Partial<UserSelections>) => ValidationResult;
+    preview: (options: PreviewOptions) => Promise<PreviewResult>;
+    validateProjectName: (name: string) => ValidationResult;
+};
+export default nexo;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAEL,mBAAmB,EAEnB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAMhC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,wBAAwB;IACxB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,4BAA4B;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA4JD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,MAAM,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,YAAY,CA4GzE,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ,GACnB,YAAY,OAAO,CAAC,cAAc,CAAC,KAClC,gBAGF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,GAAU,SAAS,cAAc,KAAG,OAAO,CAAC,aAAa,CAsB5E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAM/B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,IAAI;sBAxNqB,aAAa,KAAG,OAAO,CAAC,YAAY,CAAC;2BAiI7D,OAAO,CAAC,cAAc,CAAC,KAClC,gBAAgB;uBAyBoB,cAAc,KAAG,OAAO,CAAC,aAAa,CAAC;;CAkE7E,CAAC;AAGF,eAAe,IAAI,CAAC"}