flash-builder 1.0.12 → 1.0.14

package/README.md

@@ -1,15 +1,281 @@
-# flash-builder
+# ⚡ Flash Builder
 
-To install dependencies:
+<div align="center">
+
+```
+    ________           __       ____        _ __    __         
+   / ____/ /___ ______/ /_     / __ )__  __(_) /___/ /__  _____
+  / /_  / / __ `/ ___/ __ \   / __  / / / / / / __  / _ \/ ___/
+ / __/ / / /_/ (__  ) / / /  / /_/ / /_/ / / / /_/ /  __/ /    
+/_/   /_/\__,_/____/_/ /_/  /_____/\__,_/_/_/\__,_/\___/_/     
+```
+
+**A blazingly fast CLI tool for scaffolding modern backend projects**
+
+[![npm version](https://img.shields.io/npm/v/flash-builder.svg)](https://www.npmjs.com/package/flash-builder)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[Installation](#-installation) • [Usage](#-usage) • [Commands](#-commands) • [Examples](#-examples)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 🚀 **Lightning Fast** - Built with Bun for maximum performance
+- 📦 **Zero Configuration** - Get started immediately with sensible defaults
+- 🎯 **Multiple Templates** - Backend (Express) and MCP Server scaffolding
+- 🔄 **Auto Install** - Automatically installs dependencies after project creation
+- 🎨 **Modern Stack** - TypeScript, Express, and latest best practices
+- 🛠️ **Flexible** - Generate in current directory or create new folders
+
+---
+
+## 📦 Installation
+
+### Global Installation
 
 ```bash
-bun install
+bun install -g flash-builder@latest
 ```
 
-To run:
+---
+
+## 🚀 Usage
 
 ```bash
-bun run index.ts
+fbi <command> [options]
 ```
 
-This project was created using `bun init` in bun v1.3.6. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+### Quick Start
+
+```bash
+# Create a new backend project
+fbi be my-project-name
+
+# Create in a specific subdirectory
+fbi be my-project-name ./backend
+
+
+# Create MCP server project
+fbi mcp my-mcp-server
+
+
+# Sync interface from Flash Builder
+fbi sync
+```
+
+---
+
+## 📚 Commands
+
+### `be <project-name> [target-path]`
+
+Initialize a new backend project with Express and TypeScript.
+
+**Arguments:**
+- `project-name` - Name of your project (used in package.json)
+- `target-path` - (Optional) Target directory (`.` for current dir, `./path` for subdirectory)
+
+**Generated Structure:**
+```
+my-backend/
+├── src/
+│   ├── routes/
+│   ├── controllers/
+│   ├── models/
+│   ├── middlewares/
+│   └── index.ts
+├── .env
+├── .gitignore
+├── package.json
+└── README.md
+```
+
+**Includes:**
+- Express.js server setup
+- TypeScript configuration
+- Environment variables support
+- Auto-installed dependencies
+- Development scripts
+
+---
+
+### `mcp <project-name>`
+
+Initialize a new MCP (Model Context Protocol) server project.
+
+**Arguments:**
+- `project-name` - Name of your MCP server project
+
+**Generated Structure:**
+```
+my-mcp-server/
+├── src/
+│   ├── tools/
+│   ├── resources/
+│   └── index.ts
+├── .env
+├── .gitignore
+├── package.json
+└── README.md
+```
+
+**Includes:**
+- MCP SDK setup
+- TypeScript configuration
+- Tools and resources directories
+- Auto-installed dependencies
+
+---
+
+### `sync`
+
+Sync the current backend interface with the application target.
+
+**Usage:**
+```bash
+fbi sync
+```
+
+---
+
+## 🎯 Examples
+
+### Create Backend Project
+
+```bash
+# Standard - creates new folder
+fbi be my-api
+
+# In current directory
+fbi be my-api .
+
+# In subdirectory
+fbi be my-api ./backend
+
+# With verbose logging
+fbi be my-api --verbose
+```
+
+### Create MCP Server
+
+```bash
+# Standard MCP server
+fbi mcp my-mcp-server
+
+# With verbose logging
+fbi mcp my-mcp-server -v
+```
+
+### After Project Creation
+
+```bash
+cd my-api
+bun run dev
+```
+
+---
+
+## ⚙️ Options
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--verbose` | `-v` | Enable verbose logging |
+| `--help` | `-h` | Show help message |
+| `--version` | | Show version number |
+
+---
+
+## 🔧 Development
+
+### Prerequisites
+
+- [Bun](https://bun.sh) v1.3.6 or higher
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/jefripunza/flash-builder-cli.git
+cd flash-builder-cli
+
+# Install dependencies
+bun install
+
+# Run in development
+bun run start
+
+# Build for production
+bun run build
+
+# Compile binary
+bun run compile
+```
+
+---
+
+## 📝 Project Templates
+
+### Backend (Express) Template
+
+- **Framework:** Express.js
+- **Language:** TypeScript
+- **Runtime:** Bun
+- **Features:** 
+  - REST API structure
+  - Environment variables
+  - Hot reload in development
+  - Production build script
+
+### MCP Server Template
+
+- **Driver:** [jefriherditriyanto/langchain-mcp-api](https://hub.docker.com/r/jefriherditriyanto/langchain-mcp-api)
+- **Runtime:** Docker
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 👤 Author
+
+<a href="https://github.com/jefripunza">
+  <img src="https://github.com/jefripunza.png" width="50" height="50" alt="Jefri Herdi Triyanto" style="border-radius: 50%;">
+</a>
+
+**Jefri Herdi Triyanto** ([@jefripunza](https://github.com/jefripunza))
+
+---
+
+## 🙏 Acknowledgments
+
+- Built with [Bun](https://bun.sh) - A fast all-in-one JavaScript runtime
+- Powered by [meow](https://github.com/sindresorhus/meow) - CLI helper
+- Inspired by modern development workflows
+
+---
+
+<div align="center">
+
+**⚡ Flash Builder - Build faster, ship sooner**
+
+Made with ❤️ by [Jefri Herdi Triyanto](https://github.com/jefripunza)
+
+</div>

package/dist/index.cjs

@@ -9819,7 +9819,7 @@ var meow = (helpText, options = {}) => {
 };
 
 // version.ts
-var version = "1.0.12";
+var version = "1.0.14";
 var version_default = version;
 
 // src/banner.ts
@@ -9923,39 +9923,42 @@ function beCommand(projectName, verbose, targetPath) {
     console.log("Usage: fbi be <project-name>");
     process.exit(1);
   }
-  const isCurrentDir = targetPath === "." || targetPath?.startsWith("./");
   let projectPath;
-  let actualProjectName;
-  if (isCurrentDir && targetPath) {
-    projectPath = targetPath === "." ? PWD : import_node_path3.join(PWD, targetPath.replace("./", ""));
-    actualProjectName = projectName;
+  if (targetPath) {
+    projectPath = import_node_path3.join(PWD, targetPath);
   } else {
     projectPath = import_node_path3.join(PWD, projectName);
-    actualProjectName = projectName;
   }
-  if (import_node_fs2.existsSync(projectPath) && !isCurrentDir) {
-    if (IS_NPMJS) {
-      console.error(`\u274C Error: Directory '${projectName}' already exists`);
-      process.exit(1);
+  if (import_node_fs2.existsSync(projectPath)) {
+    const dirContent = import_node_fs2.readdirSync(projectPath);
+    const hasContent = dirContent.length > 0;
+    if (IS_NPMJS && hasContent) {
+      console.warn(`\u26A0\uFE0F  Warning: Directory '${projectName}' already exists and is not empty`);
+      const answer = prompt("Do you want to continue and overwrite? (y/n): ");
+      if (answer?.toLowerCase() !== "y") {
+        console.log("\u274C Operation cancelled");
+        process.exit(1);
+      }
+      console.log("\u2705 Continuing...");
     }
   }
   if (!IS_NPMJS) {
     import_node_fs2.rmSync(PWD, { recursive: true, force: true });
   }
-  log(`\uD83D\uDE80 Creating new backend project: ${actualProjectName}`, false, verbose);
+  log(`\uD83D\uDE80 Creating new backend project: ${projectName}`, false, verbose);
   import_node_fs2.mkdirSync(projectPath, { recursive: true });
   import_node_fs2.mkdirSync(import_node_path3.join(projectPath, "src"), { recursive: true });
   import_node_fs2.mkdirSync(import_node_path3.join(projectPath, "src", "routes"), { recursive: true });
   import_node_fs2.mkdirSync(import_node_path3.join(projectPath, "src", "controllers"), { recursive: true });
   import_node_fs2.mkdirSync(import_node_path3.join(projectPath, "src", "models"), { recursive: true });
   import_node_fs2.mkdirSync(import_node_path3.join(projectPath, "src", "middlewares"), { recursive: true });
-  const packageJsonString = JSON.stringify(packageJson(actualProjectName), null, 2);
+  const packageJsonString = JSON.stringify(packageJson(projectName), null, 2);
   import_node_fs2.writeFileSync(import_node_path3.join(projectPath, "package.json"), packageJsonString);
-  import_node_fs2.writeFileSync(import_node_path3.join(projectPath, "src", "index.ts"), indexTs(actualProjectName));
+  import_node_fs2.writeFileSync(import_node_path3.join(projectPath, "src", "index.ts"), indexTs(projectName));
   import_node_fs2.writeFileSync(import_node_path3.join(projectPath, ".env"), envFile);
   import_node_fs2.writeFileSync(import_node_path3.join(projectPath, ".gitignore"), gitignore);
-  import_node_fs2.writeFileSync(import_node_path3.join(projectPath, "README.md"), readme(actualProjectName));
-  log(`\u2705 Backend project '${actualProjectName}' created successfully!`, false, verbose);
+  import_node_fs2.writeFileSync(import_node_path3.join(projectPath, "README.md"), readme(projectName));
+  log(`\u2705 Backend project '${projectName}' created successfully!`, false, verbose);
   log(`
 \uD83D\uDCE6 Installing dependencies...`, false, verbose);
   const installProcess = Bun.spawnSync(["bun", "install"], {
@@ -9970,8 +9973,8 @@ function beCommand(projectName, verbose, targetPath) {
   }
   log(`
 Next steps:`, true, verbose);
-  if (!isCurrentDir) {
-    log(`  cd ${actualProjectName}`, true, verbose);
+  if (!targetPath) {
+    log(`  cd ${projectName}`, true, verbose);
   }
   log(`  bun run dev`, true, verbose);
 }

package/dist/index.js

@@ -9820,7 +9820,7 @@ var meow = (helpText, options = {}) => {
 };
 
 // version.ts
-var version = "1.0.12";
+var version = "1.0.14";
 var version_default = version;
 
 // src/banner.ts
@@ -9848,7 +9848,13 @@ var LLM_BASE_URL = ENV.LLM_BASE_URL;
 var LLM_API_KEY = ENV.LLM_API_KEY || "";
 
 // src/commands/be/index.ts
-import { existsSync, mkdirSync, writeFileSync, rmSync } from "fs";
+import {
+  existsSync,
+  mkdirSync,
+  writeFileSync,
+  rmSync,
+  readdirSync
+} from "fs";
 import { join } from "path";
 
 // src/utils/logger.ts
@@ -9924,39 +9930,42 @@ function beCommand(projectName, verbose, targetPath) {
     console.log("Usage: fbi be <project-name>");
     process.exit(1);
   }
-  const isCurrentDir = targetPath === "." || targetPath?.startsWith("./");
   let projectPath;
-  let actualProjectName;
-  if (isCurrentDir && targetPath) {
-    projectPath = targetPath === "." ? PWD : join(PWD, targetPath.replace("./", ""));
-    actualProjectName = projectName;
+  if (targetPath) {
+    projectPath = join(PWD, targetPath);
   } else {
     projectPath = join(PWD, projectName);
-    actualProjectName = projectName;
   }
-  if (existsSync(projectPath) && !isCurrentDir) {
-    if (IS_NPMJS) {
-      console.error(`\u274C Error: Directory '${projectName}' already exists`);
-      process.exit(1);
+  if (existsSync(projectPath)) {
+    const dirContent = readdirSync(projectPath);
+    const hasContent = dirContent.length > 0;
+    if (IS_NPMJS && hasContent) {
+      console.warn(`\u26A0\uFE0F  Warning: Directory '${projectName}' already exists and is not empty`);
+      const answer = prompt("Do you want to continue and overwrite? (y/n): ");
+      if (answer?.toLowerCase() !== "y") {
+        console.log("\u274C Operation cancelled");
+        process.exit(1);
+      }
+      console.log("\u2705 Continuing...");
     }
   }
   if (!IS_NPMJS) {
     rmSync(PWD, { recursive: true, force: true });
   }
-  log(`\uD83D\uDE80 Creating new backend project: ${actualProjectName}`, false, verbose);
+  log(`\uD83D\uDE80 Creating new backend project: ${projectName}`, false, verbose);
   mkdirSync(projectPath, { recursive: true });
   mkdirSync(join(projectPath, "src"), { recursive: true });
   mkdirSync(join(projectPath, "src", "routes"), { recursive: true });
   mkdirSync(join(projectPath, "src", "controllers"), { recursive: true });
   mkdirSync(join(projectPath, "src", "models"), { recursive: true });
   mkdirSync(join(projectPath, "src", "middlewares"), { recursive: true });
-  const packageJsonString = JSON.stringify(packageJson(actualProjectName), null, 2);
+  const packageJsonString = JSON.stringify(packageJson(projectName), null, 2);
   writeFileSync(join(projectPath, "package.json"), packageJsonString);
-  writeFileSync(join(projectPath, "src", "index.ts"), indexTs(actualProjectName));
+  writeFileSync(join(projectPath, "src", "index.ts"), indexTs(projectName));
   writeFileSync(join(projectPath, ".env"), envFile);
   writeFileSync(join(projectPath, ".gitignore"), gitignore);
-  writeFileSync(join(projectPath, "README.md"), readme(actualProjectName));
-  log(`\u2705 Backend project '${actualProjectName}' created successfully!`, false, verbose);
+  writeFileSync(join(projectPath, "README.md"), readme(projectName));
+  log(`\u2705 Backend project '${projectName}' created successfully!`, false, verbose);
   log(`
 \uD83D\uDCE6 Installing dependencies...`, false, verbose);
   const installProcess = Bun.spawnSync(["bun", "install"], {
@@ -9971,8 +9980,8 @@ function beCommand(projectName, verbose, targetPath) {
   }
   log(`
 Next steps:`, true, verbose);
-  if (!isCurrentDir) {
-    log(`  cd ${actualProjectName}`, true, verbose);
+  if (!targetPath) {
+    log(`  cd ${projectName}`, true, verbose);
   }
   log(`  bun run dev`, true, verbose);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flash-builder",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "",
   "homepage": "https://github.com/jefripunza/flash-builder-cli#readme",
   "repository": {