create-xeikit-app 1.0.0

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xeikit
+
+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,22 @@
+# 🎉 create-xeikit-app
+
+[![npm version][npm-version-src]][npm-version-href]
+
+## ✨ Usage
+
+You can use [these templates](https://github.com/xeikit/starter/tree/templates/templates) to create a new project by running the following command:
+
+```bash
+npx create-xeikit-app
+```
+
+This will prompt you to select a template and then create a new project using that template.
+
+## 📄 License
+
+[MIT](./LICENSE) License © 2025–Present [XeicuLy](https://github.com/XeicuLy)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/create-xeikit-app?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/create-xeikit-app

package/bin/cli.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { runMain } from '../dist/index.mjs';
+
+runMain();

package/dist/index.cjs

@@ -0,0 +1,7 @@
+"use strict";const citty=require("citty"),e=require("consola"),utils=require("consola/utils"),pathe=require("pathe"),stdEnv=require("std-env"),node_fs=require("node:fs"),tinyexec=require("tinyexec"),nypm=require("nypm"),giget=require("giget");function _interopDefaultCompat(t){return t&&typeof t=="object"&&"default"in t?t.default:t}const e__default=_interopDefaultCompat(e),name="create-xeikit-app",version="1.0.0",description="CLI tool for scaffolding projects with xeikit/starter templates.",handleError=t=>{e__default.error(t.toString()),process.exit(1)},verifyDirectoryDoesNotExist=t=>{node_fs.existsSync(t)&&(e__default.error(`The directory ${utils.colors.cyan(pathe.relative(process.cwd(),t)||t)} already exists. Please choose a different directory.`),process.exit(1))},resolvePath=(t,n)=>pathe.resolve(t,n),initializeGitIfRequested=async(t,n)=>{if(t===void 0?await e__default.prompt("Initialize git repository?",{type:"confirm",cancel:"reject"}).catch(()=>process.exit(1)):t){e__default.info(`Initializing git repository...
+`);try{await tinyexec.x("git",["init",n],{throwOnError:!0,nodeOptions:{stdio:"inherit"}})}catch(i){e__default.warn(`Failed to initialize git repository: ${i}`)}}},DEFAULT_REGISTRY="https://raw.githubusercontent.com/xeikit/starter/templates/templates",DEFAULT_TEMPLATE_NAME="nuxt3",PACKAGE_MANAGERS={npm:void 0,yarn:void 0,pnpm:void 0,bun:void 0,deno:void 0},PACKAGE_MANAGER_OPTIONS=Object.keys(PACKAGE_MANAGERS),TEMPLATE_OPTIONS=[{label:"Nuxt3",value:"nuxt3"}],detectCurrentPackageManager=()=>{const t=process.env.npm_config_user_agent;if(!t)return;const[n]=t.split("/");return PACKAGE_MANAGER_OPTIONS.includes(n)?n:void 0},selectPackageManager=async t=>{const n=detectCurrentPackageManager();if(t&&PACKAGE_MANAGER_OPTIONS.includes(t))return t;const i=PACKAGE_MANAGER_OPTIONS.map(r=>({label:r,value:r,hint:n===r?"current":void 0}));return e__default.prompt("Which package manager would you like to use?",{type:"select",options:i,initial:n,cancel:"reject"}).catch(()=>process.exit(1))},confirmDependenciesInstallation=async t=>{const n=await e__default.prompt("Do you want to install dependencies?",{type:"confirm",initial:t,cancel:"reject"}).catch(()=>process.exit(1));return typeof n!="boolean"&&(e__default.error("Please specify whether to install dependencies."),process.exit(1)),n},installDependenciesIfRequested=async(t,n,i)=>{if(t===!1){e__default.info("Skipping dependency installation.");return}e__default.start("Installing dependencies...");try{await nypm.installDependencies({cwd:n,packageManager:{name:i,command:i}}),e__default.success("Installation completed.")}catch(r){handleError(r)}},selectTemplate=async t=>{if(t)return t;const n=await e__default.prompt("Choose a template",{type:"select",options:TEMPLATE_OPTIONS,cancel:"reject"}).catch(()=>process.exit(1));return typeof n!="string"&&(e__default.error("Please specify a template name."),process.exit(1)),n||DEFAULT_TEMPLATE_NAME},downloadTemplateAndHandleErrors=async(t,n)=>{try{return await giget.downloadTemplate(t,{dir:n,registry:DEFAULT_REGISTRY})}catch(i){return handleError(i)}},getProjectDirectory=async t=>t!==""?t:e__default.prompt("Where would you like to create your project?",{placeholder:"./my-project",type:"text",default:"./my-project",cancel:"reject"}).catch(()=>process.exit(1)),mainCommand=citty.defineCommand({meta:{name,version,description},args:{cwd:{type:"string",description:"Specify the working directory",valueHint:"directory",default:"."},dir:{type:"positional",description:"Project directory",default:""},template:{type:"string",alias:"t",description:"Template name"},install:{type:"boolean",description:"Install dependencies"},gitInit:{type:"boolean",description:"Initialize git repository"},packageManager:{type:"string",description:"Package manager choice (npm, pnpm, yarn, bun, deno)"}},run:async({args:t})=>{stdEnv.hasTTY&&process.stdout.write(`Loading...
+`),e__default.info(utils.colors.bold("\u{1F389} Hello xeikit app!"));const n=await getProjectDirectory(t.dir),i=resolvePath(t.cwd,""),r=resolvePath(i,n);e__default.info(`Creating a new project in ${utils.colors.cyan(pathe.relative(i,r)||r)}.`),verifyDirectoryDoesNotExist(r);const s=await selectTemplate(t.template),o=await downloadTemplateAndHandleErrors(s,r),a=await selectPackageManager(t.packageManager),c=await confirmDependenciesInstallation(t.install);await installDependenciesIfRequested(c,o.dir,a),await initializeGitIfRequested(t.gitInit,o.dir),e__default.log(`
+\u{1F389} Starter project has been created with the \`${o.source}\` template.`),e__default.log(`
+\u{1F680} Next steps:
+`),e__default.log(`cd ${utils.colors.cyan(n)}`),c||e__default.log(`${utils.colors.cyan(a)} install`),e__default.log(`${utils.colors.cyan(a)} run dev`),e__default.log(`
+\u{1F3AE} Happy coding! ${utils.colors.dim("(Press Ctrl+C to stop the dev server)")}`)}}),runMain=()=>citty.runMain(mainCommand);exports.runMain=runMain;

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+declare const runMain: () => Promise<void>;
+
+export { runMain };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+declare const runMain: () => Promise<void>;
+
+export { runMain };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const runMain: () => Promise<void>;
+
+export { runMain };

package/dist/index.mjs

@@ -0,0 +1,7 @@
+import{defineCommand as u,runMain as g}from"citty";import i from"consola";import{colors as o}from"consola/utils";import{resolve as f,relative as l}from"pathe";import{hasTTY as h}from"std-env";import{existsSync as w}from"node:fs";import{x}from"tinyexec";import{installDependencies as v}from"nypm";import{downloadTemplate as E}from"giget";const k="create-xeikit-app",P="1.0.0",T="CLI tool for scaffolding projects with xeikit/starter templates.",d=e=>{i.error(e.toString()),process.exit(1)},A=e=>{w(e)&&(i.error(`The directory ${o.cyan(l(process.cwd(),e)||e)} already exists. Please choose a different directory.`),process.exit(1))},m=(e,t)=>f(e,t),I=async(e,t)=>{if(e===void 0?await i.prompt("Initialize git repository?",{type:"confirm",cancel:"reject"}).catch(()=>process.exit(1)):e){i.info(`Initializing git repository...
+`);try{await x("git",["init",t],{throwOnError:!0,nodeOptions:{stdio:"inherit"}})}catch(r){i.warn(`Failed to initialize git repository: ${r}`)}}},j="https://raw.githubusercontent.com/xeikit/starter/templates/templates",M="nuxt3",b={npm:void 0,yarn:void 0,pnpm:void 0,bun:void 0,deno:void 0},s=Object.keys(b),C=[{label:"Nuxt3",value:"nuxt3"}],_=()=>{const e=process.env.npm_config_user_agent;if(!e)return;const[t]=e.split("/");return s.includes(t)?t:void 0},D=async e=>{const t=_();if(e&&s.includes(e))return e;const r=s.map(n=>({label:n,value:n,hint:t===n?"current":void 0}));return i.prompt("Which package manager would you like to use?",{type:"select",options:r,initial:t,cancel:"reject"}).catch(()=>process.exit(1))},S=async e=>{const t=await i.prompt("Do you want to install dependencies?",{type:"confirm",initial:e,cancel:"reject"}).catch(()=>process.exit(1));return typeof t!="boolean"&&(i.error("Please specify whether to install dependencies."),process.exit(1)),t},N=async(e,t,r)=>{if(e===!1){i.info("Skipping dependency installation.");return}i.start("Installing dependencies...");try{await v({cwd:t,packageManager:{name:r,command:r}}),i.success("Installation completed.")}catch(n){d(n)}},F=async e=>{if(e)return e;const t=await i.prompt("Choose a template",{type:"select",options:C,cancel:"reject"}).catch(()=>process.exit(1));return typeof t!="string"&&(i.error("Please specify a template name."),process.exit(1)),t||M},O=async(e,t)=>{try{return await E(e,{dir:t,registry:j})}catch(r){return d(r)}},G=async e=>e!==""?e:i.prompt("Where would you like to create your project?",{placeholder:"./my-project",type:"text",default:"./my-project",cancel:"reject"}).catch(()=>process.exit(1)),L=u({meta:{name:k,version:P,description:T},args:{cwd:{type:"string",description:"Specify the working directory",valueHint:"directory",default:"."},dir:{type:"positional",description:"Project directory",default:""},template:{type:"string",alias:"t",description:"Template name"},install:{type:"boolean",description:"Install dependencies"},gitInit:{type:"boolean",description:"Initialize git repository"},packageManager:{type:"string",description:"Package manager choice (npm, pnpm, yarn, bun, deno)"}},run:async({args:e})=>{h&&process.stdout.write(`Loading...
+`),i.info(o.bold("\u{1F389} Hello xeikit app!"));const t=await G(e.dir),r=m(e.cwd,""),n=m(r,t);i.info(`Creating a new project in ${o.cyan(l(r,n)||n)}.`),A(n);const y=await F(e.template),a=await O(y,n),c=await D(e.packageManager),p=await S(e.install);await N(p,a.dir,c),await I(e.gitInit,a.dir),i.log(`
+\u{1F389} Starter project has been created with the \`${a.source}\` template.`),i.log(`
+\u{1F680} Next steps:
+`),i.log(`cd ${o.cyan(t)}`),p||i.log(`${o.cyan(c)} install`),i.log(`${o.cyan(c)} run dev`),i.log(`
+\u{1F3AE} Happy coding! ${o.dim("(Press Ctrl+C to stop the dev server)")}`)}}),R=()=>g(L);export{R as runMain};

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "create-xeikit-app",
+  "type": "module",
+  "version": "1.0.0",
+  "author": "XeicuLy",
+  "description": "CLI tool for scaffolding projects with xeikit/starter templates.",
+  "keywords": [
+    "cli",
+    "xeikit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xeikit/create-xeikit-app.git"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "bin": {
+    "create-xeikit-app": "./bin/cli.mjs"
+  },
+  "dependencies": {
+    "citty": "0.1.6",
+    "consola": "3.4.2",
+    "giget": "2.0.0",
+    "nypm": "0.6.0",
+    "pathe": "2.0.3",
+    "pkg-types": "2.1.0",
+    "std-env": "3.9.0",
+    "tinyexec": "1.0.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1.9.4",
+    "@types/node": "22.15.18",
+    "changelogen": "0.6.1",
+    "husky": "9.1.7",
+    "jiti": "2.4.2",
+    "lint-staged": "16.0.0",
+    "prettier": "3.5.3",
+    "typescript": "5.8.3",
+    "unbuild": "3.5.0"
+  },
+  "lint-staged": {
+    "**/*.{css,js,ts,cjs,mjs,cts,mts,jsx,tsx,json,jsonc}": [
+      "biome check --write --no-errors-on-unmatched"
+    ],
+    "**/*.{md,html,yaml,yml}": [
+      "prettier --write"
+    ]
+  },
+  "volta": {
+    "node": "22.15.1",
+    "pnpm": "10.11.0"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "command": "jiti bin/cli.mjs",
+    "release": "pnpm lint:fix && pnpm build && changelogen --release --push",
+    "biome": "biome check .",
+    "biome:fix": "biome check --write .",
+    "biome:ci": "biome ci .",
+    "prettier": "prettier --check .",
+    "prettier:fix": "prettier --write .",
+    "prettier:ci": "prettier --check --log-level warn .",
+    "typecheck": "tsc --noEmit",
+    "lint": "pnpm biome && pnpm prettier && pnpm typecheck",
+    "lint:fix": "pnpm biome:fix && pnpm prettier:fix && pnpm typecheck"
+  }
+}