nlfts-cli 2.1.0

package/Readme.md

@@ -0,0 +1,92 @@
+# 🚀 NL FTS CLI
+
+**Fast Template Starter (FTS)** adalah tool CLI premium yang dirancang untuk membantu developer melakukan scaffolding project starter kit dengan cepat, cerdas, dan transparan.
+
+[![Version](https://img.shields.io/npm/v/nlfts-cli)](https://www.npmjs.com/package/nlfts-cli)
+[![License](https://img.shields.io/npm/l/nlfts-cli)](https://github.com/davingm/nlfts-cli)
+
+---
+
+## ✨ Fitur Utama
+
+-   **⚡ Cepat & Ringan**: Download template dalam hitungan detik menggunakan `degit`.
+-   **📦 Smart Auto-Install**: Mendeteksi secara otomatis `npm`, `yarn`, atau `pnpm` dan menginstal dependensi segera setelah project dibuat.
+-   **📊 Real-time Progress**: Log instalasi yang transparan, tidak akan membuat Anda bingung apakah proses sedang berjalan atau tidak.
+-   **🎨 UI Premium**: Tampilan terminal yang bersih, berwarna, dan informatif terinspirasi dari tool kelas dunia seperti Laravel.
+-   **🛠 Koleksi Template**: Mendukung berbagai framework populer (Nuxt, Next.js, Express, Vue).
+
+---
+
+## 📥 Instalasi
+
+Pasang secara global melalui npm:
+
+```bash
+npm install -g nlfts-cli
+```
+
+*Atau jalankan langsung tanpa instalasi:*
+
+```bash
+npx nlfts-cli <perintah>
+```
+
+---
+
+## 🛠 Penggunaan
+
+Setelah terinstal, Anda bisa menggunakan perintah `fts`.
+
+### 1. Melihat Daftar Template
+Tampilkan semua starter kit yang tersedia beserta deskripsi dan tagnya.
+```bash
+fts list
+# atau
+fts ls
+```
+
+### 2. Membuat Project Baru
+Inisialisasi project baru dari koleksi starter kit kami.
+```bash
+fts install <nama-template> [nama-folder-project]
+# atau lebih singkat
+fts i <nama-template> [nama-folder-project]
+```
+
+**Contoh:**
+```bash
+# Membuat project Nuxt di folder 'nuxt' (default)
+fts i nuxt
+
+# Membuat project Next.js di folder 'aplikasi-saya'
+fts i next aplikasi-saya
+```
+
+---
+
+## 📋 Daftar Template Tersedia
+
+| Nama | Deskripsi | Tags |
+| :--- | :--- | :--- |
+| `nuxt` | Nuxt 3 + TailwindCSS Premium Starter | `fullstack`, `ssr` |
+| `next` | Next.js 14 + Shadcn UI + Lucide Icons | `react`, `ui` |
+| `express` | Express.js + Prisma + JWT + TypeScript | `backend`, `api` |
+| `vue` | Vue 3 + Vite + Pinia Starter Kit | `frontend`, `vite` |
+
+---
+
+## 🛠 Pengembangan (Local Development)
+
+Jika Anda ingin memodifikasi CLI ini secara lokal:
+
+1. Clone repository ini.
+2. Jalankan `npm link` di dalam folder project.
+3. Gunakan perintah `fts` untuk mencoba perubahan Anda.
+
+---
+
+## 📄 Lisensi
+
+Project ini dilisensikan di bawah **MIT License**.
+
+Dibuat dengan ❤️ oleh [davingm](https://github.com/davingm).

package/bin/index.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+
+/**
+ * FTS CLI - Installer Starter Kit Berperforma Tinggi
+ * Versi: 2.1.0
+ * Penulis: davingm
+ */
+
+import { Command } from 'commander';
+import degit from 'degit';
+import ora from 'ora';
+import chalk from 'chalk';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+// --- Konfigurasi & Konstanta ---
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Daftar template yang tersedia
+const TEMPLATES = {
+    'nuxt': {
+        repo: 'github:davingm/MyStudio',
+        desc: 'Nuxt 3 + TailwindCSS Starter Kit Premium',
+        tags: ['fullstack', 'frontend', 'ssr']
+    },
+    'next': {
+        repo: 'github:davinalifp/next-starter',
+        desc: 'Next.js 14 + Shadcn UI + Lucide Icons',
+        tags: ['react', 'nextjs', 'ui']
+    },
+    'express': {
+        repo: 'github:davinalifp/express-api-starter',
+        desc: 'Express.js + Prisma + JWT + TypeScript',
+        tags: ['backend', 'api', 'database']
+    },
+    'vue': {
+        repo: 'github:vuejs/starter-vite',
+        desc: 'Vue 3 + Vite + Pinia Starter Kit',
+        tags: ['frontend', 'vite', 'vue']
+    }
+};
+
+const UI = {
+    // Garis pembatas untuk kerapihan terminal
+    divider: () => console.log(chalk.dim('─'.repeat(Math.min(process.stdout.columns || 80, 80)))),
+    spacer: () => console.log(''),
+    // Banner utama CLI
+    banner: () => {
+        console.clear();
+        console.log(chalk.bold.cyan(`
+   ███████╗████████╗███████╗
+   ██╔════╝╚══██╔══╝██╔════╝
+   █████╗     ██║   ███████╗
+   ██╔══╝     ██║   ╚════██║
+   ██║        ██║   ███████║
+   ╚═╝        ╚═╝   ╚══════╝ `));
+        console.log(chalk.cyan.bold('   Fast Template Starter CLI v2.1'));
+        console.log(chalk.dim('   "Membangun masa depan, satu perintah sekaligus."\n'));
+    }
+};
+
+// --- Fungsi Pembantu (Helpers) ---
+
+// Mendeteksi package manager yang digunakan user
+const getPackageManager = () => {
+    const userAgent = process.env.npm_config_user_agent || '';
+    if (userAgent.includes('yarn')) return 'yarn';
+    if (userAgent.includes('pnpm')) return 'pnpm';
+    if (userAgent.includes('bun')) return 'bun';
+    return 'npm';
+};
+
+/**
+ * Menjalankan perintah terminal dan mengalirkan output secara real-time
+ */
+const runCommand = (command, args, cwd) => {
+    return new Promise((resolve, reject) => {
+        const isWindows = process.platform === 'win32';
+        
+        try {
+            // Mengatasi DEP0190: Menggunakan shell string tunggal untuk Windows
+            const child = isWindows 
+                ? spawn(`${command} ${args.join(' ')}`, { cwd, shell: true, stdio: ['inherit', 'pipe', 'pipe'] })
+                : spawn(command, args, { cwd, shell: false, stdio: ['inherit', 'pipe', 'pipe'] });
+
+            child.stdout.on('data', (data) => {
+                const lines = data.toString().split('\n');
+                lines.forEach(line => {
+                    if (line.trim()) {
+                        process.stdout.write(chalk.dim(`  ⚡ ${line.trim()}\n`));
+                    }
+                });
+            });
+
+            child.stderr.on('data', (data) => {
+                const line = data.toString().trim();
+                if (line) {
+                    process.stdout.write(chalk.dim(`  ⚡ ${line}\n`));
+                }
+            });
+
+            child.on('error', (err) => {
+                reject(err);
+            });
+
+            child.on('close', (code) => {
+                if (code === 0) resolve();
+                else reject(new Error(`Proses berhenti dengan kode ${code}`));
+            });
+        } catch (e) {
+            reject(e);
+        }
+    });
+};
+
+// --- Logika Utama Aplikasi ---
+
+const program = new Command();
+
+program
+    .name('fts')
+    .description('Tools CLI Premium untuk scaffolding project Anda')
+    .version('2.1.0');
+
+// PERINTAH: LIST (Melihat daftar template)
+program
+    .command('list')
+    .alias('ls')
+    .description('Tampilkan semua starter kit yang tersedia')
+    .action(() => {
+        UI.banner();
+        console.log(chalk.bold('Daftar Template Tersedia:'));
+        UI.spacer();
+
+        Object.entries(TEMPLATES).forEach(([name, info]) => {
+            const namePath = chalk.green.bold(name.padEnd(12));
+            const tags = info.tags.map(t => chalk.bgCyan.black(` ${t} `)).join(' ');
+            console.log(`  ${chalk.cyan('➜')} ${namePath} ${tags}`);
+            console.log(`    ${chalk.dim(info.desc)}`);
+            UI.spacer();
+        });
+
+        UI.divider();
+        console.log(chalk.dim(`  Jalankan ${chalk.yellow('fts install <nama>')} untuk mulai membangun.`));
+        UI.spacer();
+    });
+
+// PERINTAH: INSTALL (Membuat project baru)
+program
+    .command('install <template> [project-name]')
+    .alias('i')
+    .description('Inisialisasi project baru dari starter kit')
+    .action(async (template, projectName) => {
+        UI.banner();
+
+        const selectedTemplate = TEMPLATES[template.toLowerCase()];
+        if (!selectedTemplate) {
+            console.log(chalk.red(`  [ERROR] Template "${template}" tidak ditemukan dalam koleksi.`));
+            console.log(chalk.dim(`  Coba jalankan ${chalk.cyan('fts list')} untuk melihat pilihan.\n`));
+            return;
+        }
+
+        const targetDir = projectName || template;
+        const fullPath = path.join(process.cwd(), targetDir);
+
+        // Validasi: Cek apakah folder tujuan sudah ada
+        if (fs.existsSync(fullPath)) {
+            console.log(chalk.red(`  [ERROR] Folder "${targetDir}" sudah ada.`));
+            console.log(chalk.dim(`  Silakan gunakan nama lain atau hapus folder tersebut terlebih dahulu.\n`));
+            return;
+        }
+
+        console.log(chalk.bold.blue(`  ✨ Persiapan: ${chalk.white(selectedTemplate.desc)}`));
+        console.log(chalk.dim(`  📍 Lokasi: ${fullPath}`));
+        UI.spacer();
+
+        const spinner = ora({
+            text: 'Mengambil artifacts template...',
+            color: 'cyan',
+            spinner: 'dots12'
+        }).start();
+
+        try {
+            // LANGKAH 1: Download Template menggunakan degit
+            const emitter = degit(selectedTemplate.repo, { cache: false, force: true });
+            await emitter.clone(targetDir);
+            spinner.succeed(chalk.green(' Berhasil mendownload artifacts template.'));
+
+            // LANGKAH 2: Menginstall Dependensi
+            const pkgManager = getPackageManager();
+            UI.spacer();
+            console.log(chalk.bold.yellow(`  📦 Menginstal dependensi melalui ${pkgManager}...`));
+            UI.divider();
+
+            try {
+                // Parameter tambahan untuk mempercepat & memperbersih log
+                const args = pkgManager === 'yarn' ? [] : ['install', '--no-audit', '--no-fund'];
+                await runCommand(pkgManager, args, fullPath);
+                
+                UI.divider();
+                console.log(chalk.green(`  ✅ Semua dependensi berhasil terinstall.`));
+            } catch (err) {
+                UI.divider();
+                console.log(chalk.red(`  ⚠️  Gagal menginstal otomatis. Silakan jalankan "${pkgManager} install" secara manual.`));
+                console.log(chalk.dim(`     Alasan: ${err.message}`));
+            }
+
+            // RINGKASAN SUKSES
+            UI.spacer();
+            console.log(chalk.bgGreen.black.bold(' SUKSES ') + chalk.green(' Project Anda siap untuk dikembangkan!'));
+            UI.spacer();
+            
+            console.log(chalk.white(' Ikuti langkah berikut untuk memulai:'));
+            console.log(chalk.cyan(`   1. cd ${targetDir}`));
+            if (pkgManager === 'npm') {
+                console.log(chalk.cyan('   2. npm run dev'));
+            } else {
+                console.log(chalk.cyan(`   2. ${pkgManager} dev`));
+            }
+            UI.spacer();
+            UI.divider();
+            console.log(chalk.dim('   Selamat Berkarya! – Tim FTS'));
+            UI.spacer();
+
+        } catch (err) {
+            // Penanganan error saat download atau inisialisasi awal
+            spinner.fail(chalk.red(' Gagal menyiapkan project.'));
+            UI.spacer();
+            console.log(chalk.bgRed.white(' DETAIL ERROR '));
+            console.error(chalk.red(err.message));
+            UI.spacer();
+        }
+    });
+
+program.parse();  

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "nlfts-cli",
+  "version": "2.1.0",
+  "description": "CLI Premium untuk scaffolding project starter kit dengan cepat dan cerdas.",
+  "main": "./bin/index.js",
+  "bin": {
+    "fts": "./bin/index.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "starter-kit",
+    "nuxt",
+    "nextjs",
+    "express",
+    "fts",
+    "automation"
+  ],
+  "author": "davingm",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "degit": "^2.8.4",
+    "ora": "^9.3.0"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}