metabinaries 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed khairy
+
+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,43 @@
+# MetaBinaries CLI
+
+A powerful CLI tool to initialize advanced, enterprise-grade CRM projects using Next.js 15, Redux Toolkit, and a feature-based internal architecture.
+
+## 🚀 Quick Start
+
+You can use the CLI directly via `npx` without installation:
+
+```bash
+npx metabinaries <project-name>
+```
+
+Or install it globally:
+
+```bash
+npm install -g metabinaries
+metaBinaries <project-name>
+```
+
+## ✨ Features of Generated Projects
+
+- **Next.js 15 (App Router)**: High-performance modern web architecture.
+- **Feature-Based Architecture**: Business logic isolated in `lib/features/`.
+- **Internationalization (i18n)**: Out-of-the-box support for English (LTR) and Arabic (RTL).
+- **State Management**: Pre-configured Redux Toolkit.
+- **Modern UI**: Tailwind CSS v4, Shadcn UI, and Framer Motion.
+- **Form Validation**: Zod & React Hook Form.
+- **Quality Tools**: Husky hooks and Conventional Commits configuration.
+
+## 📁 Generated Structure
+
+The CLI generates a standardized folder structure including:
+- `app/[locale]/`: Localized routes and layouts.
+- `lib/features/`: Feature-specific logic (API, Services, Slices, Hooks).
+- `components/ui/`: Reusable primitive components.
+- `i18n/`: Advanced routing logic for multi-language support.
+
+## 🤝 Contributing
+
+This CLI is developed and maintained by the **MetaBinaries Technical Team**.
+
+---
+License: MIT

package/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { folderStructure, getTemplateFiles, dependencies, devDependencies } from './src/constants.js';
+import { runCommand } from './src/utils.js';
+
+import chalk from 'chalk';
+import ora from 'ora';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+let projectName = process.argv[2];
+
+// Support "metaBinaries create [name]" or "metaBinaries create project [name]"
+if (projectName === 'create') {
+  projectName = process.argv[3];
+  if (projectName === 'project') {
+    projectName = process.argv[4];
+  }
+}
+
+if (!projectName) {
+  console.error(chalk.red('❌ Please provide a project name'));
+  console.log(chalk.cyan('Usage:'));
+  console.log(chalk.cyan('  npx metaBinaries <project-name>'));
+  console.log(chalk.cyan('  npx metaBinaries create <project-name>'));
+  process.exit(1);
+}
+
+// Security: Validate project name to prevent command injection or path traversal
+const safeProjectNameRegex = /^[a-zA-Z0-9-_]+$/;
+if (!safeProjectNameRegex.test(projectName)) {
+  console.error(chalk.red('❌ Invalid project name. Only alphanumeric characters, dashes, and underscores are allowed.'));
+  process.exit(1);
+}
+
+// ==================== MAIN FUNCTION ====================
+async function createProject() {
+  const spinner = ora();
+  
+  try {
+    console.log(chalk.bold.blue(`\n🚀 Creating MetaBinaries project: ${projectName}`));
+    console.log(chalk.bold.cyan(`✨ Developed by: MetaBinaries Technical Team\n`));
+
+    // Step 1: Initialize Next.js
+    console.log(chalk.yellow('📦 Initializing Next.js... (Please answer the prompts below)'));
+    await runCommand('npx', [
+      'create-next-app@latest',
+      projectName,
+      '--skip-install',
+      '--skip-git'
+    ]);
+    console.log(chalk.green('✅ Next.js initialized successfully!'));
+
+    const projectPath = path.join(process.cwd(), projectName);
+    process.chdir(projectPath);
+
+    // Step 2: Create folder structure
+    spinner.start(chalk.yellow('📁 Creating folder structure...'));
+    for (const folder of folderStructure) {
+      await fs.ensureDir(folder);
+    }
+    spinner.succeed(chalk.green('Folder structure created'));
+
+    // Step 3: Write template files
+    spinner.start(chalk.yellow('📝 Writing template files...'));
+    const templateFiles = getTemplateFiles(projectName);
+    for (const [filePath, content] of Object.entries(templateFiles)) {
+      await fs.ensureDir(path.dirname(filePath));
+      await fs.writeFile(filePath, content);
+    }
+    spinner.succeed(chalk.green('Template files created'));
+
+    // Step 4: [Merged into Step 3]
+    spinner.succeed(chalk.green('Next.js configured via templates'));
+
+    // Step 5: Install dependencies
+    spinner.start(chalk.yellow('📚 Installing base dependencies...'));
+    await runCommand('npm', ['install']);
+    spinner.succeed(chalk.green('Base dependencies installed'));
+
+    spinner.start(chalk.yellow('📚 Installing additional libraries...'));
+    await runCommand('npm', ['install', ...dependencies]);
+    spinner.succeed(chalk.green('Additional dependencies installed'));
+
+    spinner.start(chalk.yellow('📚 Installing dev dependencies...'));
+    await runCommand('npm', ['install', '-D', ...devDependencies]);
+    spinner.succeed(chalk.green('Dev dependencies installed'));
+
+    // Step 6: Git will be initialized at the end after all files are written
+
+    // Step 7: Configure Husky & Scripts
+    spinner.start(chalk.yellow('🐶 Configuring Husky & Scripts...'));
+    try {
+      // Add scripts to package.json
+      const pkgPath = path.join(process.cwd(), 'package.json');
+      const pkg = await fs.readJson(pkgPath);
+      pkg.scripts = {
+        ...pkg.scripts,
+        "dev": "next dev",
+        "build": "npm run build:clean && npm run format && npm run build:next",
+        "build:clean": "rimraf .next && rimraf node_modules/.prisma",
+        "build:next": "next build --turbopack",
+        "build:production": "npm run build:clean && npm run format && npm run build:next",
+        "build:deploy": "npm run build:production",
+        "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,css,scss,md}\"",
+        "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,css,scss,md}\"",
+        "type-check": "tsc --noEmit",
+        "lint-staged": "lint-staged",
+        "prepare": "husky"
+      };
+      await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+
+      // Initialize Husky
+      await runCommand('npx', ['husky', 'init']);
+      
+      // Overwrite husky hooks with our templates
+      for (const [filePath, content] of Object.entries(templateFiles)) {
+        if (filePath.startsWith('.husky/')) {
+          await fs.writeFile(filePath, content);
+          // Make hook executable on Unix-like systems
+          if (process.platform !== 'win32') {
+            await runCommand('chmod', ['+x', filePath]);
+          }
+        }
+      }
+      spinner.succeed(chalk.green('Husky configured'));
+    } catch (error) {
+      spinner.warn(chalk.yellow('Husky configuration skipped or failed'));
+    }
+
+    // Step 8: Initialize Git and make initial commit (after all files are written)
+    spinner.start(chalk.yellow('🔧 Initializing Git...'));
+    try {
+      await runCommand('git', ['init']);
+      await runCommand('git', ['add', '.']);
+      await runCommand('git', ['commit', '-m', 'feat: initial commit from MetaBinaries']);
+      spinner.succeed(chalk.green('Git initialized with all files committed'));
+    } catch (e) {
+      spinner.warn(chalk.yellow('Git initialization skipped'));
+    }
+
+    // Success message
+    console.log(chalk.bold.green('\n🎉 Project created successfully!\n'));
+    console.log(chalk.white('📋 Next steps:'));
+    console.log(chalk.cyan(`   cd ${projectName}`));
+    console.log(chalk.cyan('   npm run dev\n'));
+    console.log(chalk.white('💡 Project includes:'));
+    console.log(chalk.gray('   • Feature-based architecture'));
+    console.log(chalk.gray('   • Redux Toolkit state management'));
+    console.log(chalk.gray('   • Internationalization (en/ar)'));
+    console.log(chalk.gray('   • Authentication structure'));
+    console.log(chalk.gray('   • Shared components & utilities\n'));
+
+  } catch (error) {
+    spinner.fail(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+createProject();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "metabinaries",
+  "version": "1.0.0",
+  "description": "MetaBinaries project initializer",
+  "main": "index.js",
+  "bin": {
+    "metabinaries": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node index.js test-project"
+  },
+  "keywords": [
+    "nextjs",
+    "cli",
+    "template",
+    "boilerplate"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "fs-extra": "^11.3.3",
+    "ora": "^9.0.0"
+  }
+}

package/src/constants.js

@@ -0,0 +1,62 @@
+// Main constants file - aggregates all template modules
+// =======================================================
+
+// Import from separate template files
+import { folderStructure } from './templates/folder-structure.js';
+import { dependencies, devDependencies } from './templates/packages.js';
+import { appTemplates } from './templates/app.js';
+import { layoutTemplates } from './templates/layout.js';
+import { coreTemplates } from './templates/core.js';
+import { uiTemplates } from './templates/ui.js';
+import { uiTemplates2 } from './templates/ui-2.js';
+import { uiTemplates3 } from './templates/ui-3.js';
+import { uiTemplates4 } from './templates/ui-4.js';
+import { configTemplates } from './templates/configs.js';
+import { miscTemplates } from './templates/misc.js';
+
+// Re-export folderStructure
+export { folderStructure };
+
+// Re-export dependencies
+export { dependencies, devDependencies };
+
+// Helper function to resolve template values (handles both strings and functions)
+const resolveTemplates = (templates, projectName) => {
+  const resolved = {};
+  for (const [key, value] of Object.entries(templates)) {
+    resolved[key] = typeof value === 'function' ? value(projectName) : value;
+  }
+  return resolved;
+};
+
+// Combine all templates into a single getTemplateFiles function
+export const getTemplateFiles = (projectName) => {
+  return {
+    // App Routes & Layouts
+    ...resolveTemplates(appTemplates, projectName),
+
+    // Layout & Shared Components
+    ...resolveTemplates(layoutTemplates, projectName),
+
+    // Core templates (lib, utils, i18n)
+    ...resolveTemplates(coreTemplates, projectName),
+
+    // UI Components Part 1 (Alert, AnimatedGroup, Avatar, Badge, Breadcrumb, Button, Card)
+    ...resolveTemplates(uiTemplates, projectName),
+
+    // UI Components Part 2 (Empty, InputGroup, Input, Label, NavigationMenu, Skeleton)
+    ...resolveTemplates(uiTemplates2, projectName),
+
+    // UI Components Part 3 (Sonner, Stepper, Switch, Table, TextEffect, Textarea, Tooltip)
+    ...resolveTemplates(uiTemplates3, projectName),
+
+    // UI Components Part 4 (Checkbox, Collapsible, Popover, ScrollArea, Separator)
+    ...resolveTemplates(uiTemplates4, projectName),
+
+    // Configuration files
+    ...resolveTemplates(configTemplates, projectName),
+
+    // Documentation and Husky hooks
+    ...resolveTemplates(miscTemplates, projectName),
+  };
+};