blux-start 1.0.0 → 1.2.0

package/bin/index.js

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
 
 import { Command } from 'commander';
+import { input } from '@inquirer/prompts'
+
 import chalk from 'chalk';
 import fs from 'fs-extra';
 import path from 'path';
+import { spawn } from 'child_process'
 
 const program = new Command();
 
@@ -12,6 +15,7 @@ program
   .description('A simple CLI to scaffold a TypeScript boilerplate project for blu projects')
   .version('1.0.0');
 
+
 program
   .command('init')
   .argument('<project-name>', 'Name of the project directory')
@@ -280,14 +284,44 @@ export async function DbConnect(){
 
       // 5. Success Message
       console.log(chalk.green(`✨ Successfully scaffolded ${chalk.bold(projectName)}!`));
-      console.log('\nNext steps:');
-      console.log(chalk.cyan(`  cd ${projectName}`));
-      console.log(chalk.cyan('  npm install'));
-      console.log(chalk.cyan('  npm run dev\n'));
 
+      // Vite ? 
+
+      const vite = await input({
+        message:'Would you like create a client-side application ?: (y/n)',
+        required:false
+      })
+
+      if(vite === 'y'){
+          console.log(chalk.blue('\n🚀 Kicking off Vite process...\n'));        
+          const viteProcess = spawn('npm', ['create', 'vite@latest'], {
+            cwd: process.cwd(), 
+            stdio: 'inherit',   
+            shell: true    
+          });
+
+          viteProcess.on('close', (code) => {
+            if (code === 0) {
+              console.log(chalk.green('\n✨ Client application successfully scaffolded with Vite!'));
+            } else {
+              console.log(chalk.red(`\nVite scaffolding exited with code ${code}`));
+            }
+          });
+      }
+      else {
+        console.log('\nNext steps:');
+        console.log(chalk.cyan(`  cd ${projectName}`));
+        console.log(chalk.cyan('  npm install'));
+        console.log(chalk.cyan('  npm run dev\n'));
+      }
     } catch (err) {
-      console.error(chalk.red('❌ Something went wrong during generation:'), err);
+      if(err.message){
+        console.error(chalk.red(err.message))
+      }{
+        console.error(chalk.red('❌ Something went wrong during generation:'), err);
+      }
     }
-  });
+})
+
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blux-start",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "",
   "license": "ISC",
   "author": "Xavier",
@@ -13,9 +13,11 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
+    "@inquirer/prompts": "^8.5.2",
     "chalk": "^5.6.2",
     "commander": "^15.0.0",
     "fs-extra": "^11.3.5",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "vite": "^8.0.16"
   }
 }

package/readme.md

@@ -0,0 +1,27 @@
+# blux-start
+
+A zero-configuration CLI boilerplate generator to kickstart Node.js applications with a production-ready stack.
+
+## ✨ Features
+
+* **TypeScript** - Fully configured compiler and path aliases
+* **Express** - Fast, unopinionated, minimalist web framework
+* **MSSQL** - Pre-configured Microsoft SQL Server database integration
+* **Structure** - Organized folder layout for scalable architecture
+
+## 🚀 Quick Start
+
+You can generate a new project instantly without installing the package globally. Run the following command in your terminal:
+
+```bash
+npx blux-start@latest init <projectName>
+```
+
+Replace `<projectName>` with the actual name of your project folder.
+
+## 📋 Prerequisites
+
+Before running the boilerplate, ensure you have the following installed on your machine:
+
+* **Node.js** (v18.0.0 or higher recommended)
+* **npm** (v9.0.0 or higher)

package/testthis/app.ts

@@ -0,0 +1,50 @@
+
+import { DbConnect } from './db/db.ts'
+import createError from 'http-errors';
+import express from 'express';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import cookieParser from 'cookie-parser';
+import logger from 'morgan';
+import cors from 'cors'
+
+import indexRouter from './routes/index.ts';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const app = express();
+
+// view engine setup
+// app.set('views', path.join(__dirname, 'views'));
+// app.set('view engine', 'html');
+
+app.use(cors({
+  origin:"localhost:5173" // local reactapp
+}))
+
+app.use(logger('dev'));
+app.use(express.json());
+app.use(express.urlencoded({ extended: false }));
+app.use(cookieParser());
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.use('/', indexRouter);
+
+// catch 404 and forward to error handler
+app.use(function(req, res, next) {
+  next(createError(404));
+});
+
+// setup connection DbConnect()
+
+// error handler
+app.use((err: { message: string; status?: number }, req: express.Request, res: express.Response, _next: express.NextFunction) => {
+  res.locals.message = err.message;
+  res.locals.error = req.app.get('env') === 'development' ? err : {};
+
+  res.status(err.status || 500);
+});
+
+export default app;
+
+
+    

package/testthis/bin/www

@@ -0,0 +1,65 @@
+
+import app from '../app.ts';
+import debugLib from 'debug';
+import http from 'http';
+
+const debug = debugLib('site:server');
+
+const port = normalizePort(process.env.PORT || '3000');
+app.set('port', port);
+
+const server = http.createServer(app);
+
+server.listen(port);
+server.on('error', onError);
+server.on('listening', onListening);
+
+
+console.log('Listening on port: 3000');
+
+
+function normalizePort(val) {
+  const port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    return val;
+  }
+
+  if (port >= 0) {
+    return port;
+  }
+
+  return false;
+}
+
+function onError(error) {
+  if (error.syscall !== 'listen') {
+    throw error;
+  }
+
+  const bind = typeof port === 'string'
+    ? 'Pipe ' + port
+    : 'Port ' + port;
+
+  switch (error.code) {
+    case 'EACCES':
+      console.error(bind + ' requires elevated privileges');
+      process.exit(1);
+      break;
+    case 'EADDRINUSE':
+      console.error(bind + ' is already in use');
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+}
+
+function onListening() {
+  const addr = server.address();
+  const bind = typeof addr === 'string'
+    ? 'pipe ' + addr
+    : 'port ' + addr.port;
+  debug('Listening on ' + bind);
+}
+      

package/testthis/db/db.ts

@@ -0,0 +1,13 @@
+
+import sql  from 'mssql' 
+import dotenv from 'dotenv'
+
+export async function DbConnect(){
+    try {
+        const conn = await sql.connect('Server=dbhost,port;Database=dbname;User Id=dbuser;Password=$dbpass;Encrypt=true')
+        console.log('DB Con Status: ',conn.healthy)
+    } catch (err) {
+        console.log(err)
+    }
+}
+      

package/testthis/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "testthis",
+  "version": "1.0.0",
+  "description": "Backend generated by xtech",
+  "main": "./bin/www",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node ./bin/www",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "cookie-parser": "~1.4.4",
+    "cors": "^2.8.6",
+    "debug": "~2.6.9",
+    "dotenv": "^17.4.2",
+    "express": "~4.16.1",
+    "http-errors": "~1.6.3",
+    "morgan": "~1.9.1",
+    "nodemon": "^3.1.14",
+    "mssql": "^12.5.5"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@types/node": "^25.9.3",
+    "tsx": "^4.22.4",
+    "@types/cookie-parser": "^1.4.10",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/morgan": "^1.9.10"
+  }
+}

package/testthis/routes/index.ts

@@ -0,0 +1,14 @@
+
+import { Router } from 'express';
+import type { Request, Response, NextFunction } from 'express';
+
+const router = Router();
+
+router.get('/', (_req: Request, _res: Response, _next: NextFunction) => {
+    _res.json({
+        message:"HELLO FROM SERVER"
+    })
+});
+
+export default router;
+      

package/testthis/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "module": "nodenext",
+    "target": "esnext",
+    "types": [],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+    "rewriteRelativeImportExtensions": true,
+    "allowImportingTsExtensions": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}

package/vite-project/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

package/vite-project/eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+    },
+  },
+])

package/vite-project/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>vite-project</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>