devfast 1.0.0

package/README.md

@@ -0,0 +1,9 @@
+# devfast CLI
+
+A fast scaffolding tool to generate projects from the devfast platform.
+
+## Usage
+
+```bash
+npx devfast create <template-id>
+```

package/dist/bin/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createAction } from '../src/commands/create.js';
+const program = new Command();
+program
+    .name('devfast')
+    .description('CLI to scaffold projects from devfast')
+    .version('1.0.0');
+program
+    .command('create <template-id>')
+    .action(createAction);
+program.parse(process.argv);

package/dist/src/api.js

@@ -0,0 +1,18 @@
+import axios from 'axios';
+const API_BASE = process.env.NODE_ENV === 'development'
+    ? 'http://localhost:3000'
+    : 'https://devfastv1.vercel.app';
+export async function fetchTemplate(id) {
+    try {
+        const { data } = await axios.get(`${API_BASE}/api/cli/template`, {
+            params: { id }
+        });
+        return data;
+    }
+    catch (err) {
+        return {
+            status: err.response?.status || 500,
+            error: err.response?.data?.message || 'Server unreachable'
+        };
+    }
+}

package/dist/src/commands/create.js

@@ -0,0 +1,55 @@
+import prompts from 'prompts';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import degit from 'degit';
+import { fetchTemplate } from '../api.js';
+import { isValidProjectPath, isValidFolderName, isDirEmpty, formatMessage } from '../utils.js';
+export async function createAction(templateId) {
+    const template = await fetchTemplate(templateId);
+    if (template.status !== 200 || !template.data) {
+        console.error(chalk.red(`Error: ${template.error || 'Invalid template ID'}`));
+        process.exit(1);
+    }
+    const response = await prompts({
+        type: 'text',
+        name: 'projectPath',
+        message: 'Project name or path:',
+        initial: templateId,
+        validate: (val) => {
+            if (!isValidProjectPath(val))
+                return 'Invalid characters in path';
+            const resolvedPath = path.resolve(process.cwd(), val);
+            const folderName = path.basename(resolvedPath);
+            if (val === '.')
+                return true;
+            return isValidFolderName(folderName) ? true : 'Folder name must be small letters, numbers, and dashes';
+        }
+    });
+    if (!response.projectPath)
+        process.exit(1);
+    const targetDir = path.resolve(process.cwd(), response.projectPath);
+    const relativePath = path.relative(process.cwd(), targetDir) || '.';
+    const appName = response.projectPath === '.' ? path.basename(process.cwd()) : path.basename(targetDir);
+    if (!isDirEmpty(targetDir)) {
+        console.error(chalk.red(`Directory "${response.projectPath}" is not empty.`));
+        process.exit(1);
+    }
+    const templateData = { APP_NAME: appName, RELATIVE_PATH: relativePath };
+    // Format and Log Welcome Message
+    console.log(`\n${formatMessage(template.data.welcomeMessage, templateData)}`);
+    const spinner = ora('Setting up project...').start();
+    try {
+        const emitter = degit(template.data.repository, { force: true });
+        await emitter.clone(targetDir);
+        spinner.succeed(chalk.green('Done!'));
+        // Format and Log Next Steps
+        console.log(`\n${chalk.bold('Next steps:')}`);
+        console.log(formatMessage(template.data.nextSteps, templateData));
+        process.exit(0);
+    }
+    catch (err) {
+        spinner.fail(chalk.red('Setup failed.'));
+        process.exit(1);
+    }
+}

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/utils.js

@@ -0,0 +1,24 @@
+import fs from 'fs-extra';
+import chalk from 'chalk';
+export function isValidProjectPath(input) {
+    return /^[a-z0-9-./\\]+$/.test(input);
+}
+export function isValidFolderName(name) {
+    return /^[a-z0-9-]+$/.test(name);
+}
+export function isDirEmpty(path) {
+    return !fs.existsSync(path) || fs.readdirSync(path).length === 0;
+}
+export function formatMessage(message, data) {
+    // 1. Replace Placeholders
+    let formatted = message
+        .replace(/{{APP_NAME}}/g, data.APP_NAME)
+        .replace(/{{RELATIVE_PATH}}/g, data.RELATIVE_PATH);
+    // 2. Replace [color] tags using Regex
+    // Matches [colorName]content[/colorName]
+    const colorRegex = /\[(\w+)\]([\s\S]*?)\[\/\1\]/g;
+    return formatted.replace(colorRegex, (_, color, content) => {
+        const chalkMethod = chalk[color];
+        return typeof chalkMethod === 'function' ? chalkMethod(content) : content;
+    });
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "devfast",
+  "version": "1.0.0",
+  "description": "Devfast template setup library",
+  "type": "module",
+  "main": "dist/src/api.js",
+  "bin": {
+    "devfast": "dist/bin/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "dev": "NODE_ENV=development node dist/bin/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "degit": "^2.8.4",
+    "fs-extra": "^11.3.4",
+    "ora": "^9.3.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/degit": "^2.8.6",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.5.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.9.3"
+  }
+}