create-commandkit 1.2.0-dev.20251019020542 → 1.2.0-dev.20251019062347

package/README.md

@@ -14,6 +14,9 @@ create-commandkit is a CLI utility to quickly instantiate a Discord bot with Com
 
 - Interactive, beautiful command-line interface 🖥️
 - Supports CommonJS and ES Modules 📦
+- Dynamic template system with examples from GitHub 🚀
+- Support for all major package managers (npm, pnpm, yarn, bun, deno) 📦
+- TypeScript and JavaScript support 🔧
 
 ## Documentation
 
@@ -21,12 +24,75 @@ You can find the full documentation [here](https://commandkit.dev).
 
 ## Usage
 
-Run the following command in your terminal:
+### Basic Usage
 
 ```sh
 npx create-commandkit@latest
 ```
 
+### With Project Name
+
+```sh
+npx create-commandkit@latest my-bot
+```
+
+### Using Examples
+
+```sh
+# Use a curated example
+npx create-commandkit@latest --example with-database
+
+# Use a custom GitHub repository
+npx create-commandkit@latest --example "https://github.com/user/repo"
+
+# Use a specific path within a repository
+npx create-commandkit@latest --example "https://github.com/user/repo" --example-path "examples/bot"
+```
+
+### CLI Options
+
+- `-h, --help` - Show all available options
+- `-V, --version` - Output the version number
+- `-e, --example <name-or-url>` - An example to bootstrap the app with
+- `--example-path <path>` - Specify the path to the example separately
+- `--use-npm` - Use npm as package manager
+- `--use-pnpm` - Use pnpm as package manager
+- `--use-yarn` - Use yarn as package manager
+- `--use-bun` - Use bun as package manager
+- `--use-deno` - Use deno as package manager
+- `--skip-install` - Skip installing packages
+- `--no-git` - Skip git initialization
+- `--yes` - Use defaults for all options
+- `--list-examples` - List all available examples from the official repository
+
+### Available Examples
+
+<!-- BEGIN_AVAILABLE_EXAMPLES -->
+- `basic-js` - [examples/basic-js](https://github.com/underctrl-io/commandkit/tree/main/examples/basic-js)
+- `basic-ts` - [examples/basic-ts](https://github.com/underctrl-io/commandkit/tree/main/examples/basic-ts)
+- `deno-ts` - [examples/deno-ts](https://github.com/underctrl-io/commandkit/tree/main/examples/deno-ts)
+- `without-cli` - [examples/without-cli](https://github.com/underctrl-io/commandkit/tree/main/examples/without-cli)
+<!-- END_AVAILABLE_EXAMPLES -->
+
+### Examples
+
+```sh
+# Create a basic TypeScript bot, skip installation
+npx create-commandkit@latest --example basic-ts --skip-install
+
+# Create a bot with all defaults (no prompts)
+npx create-commandkit@latest --yes
+
+# Create a bot from custom repository
+npx create-commandkit@latest --example "https://github.com/username/my-commandkit-template"
+
+# Create a bot with pnpm
+npx create-commandkit@latest --use-pnpm
+
+# List all available examples
+npx create-commandkit@latest --list-examples
+```
+
 ## Support and Suggestions
 
 Submit any queries or suggestions in our [Discord community](https://ctrl.lol/discord).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+import type { CLIOptions } from './types.js';
+export declare function parseCLI(): CLIOptions;

package/dist/cli.js

@@ -0,0 +1,39 @@
+import { Command } from 'commander';
+export function parseCLI() {
+    const program = new Command();
+    program
+        .name('create-commandkit')
+        .description('Effortlessly create a CommandKit project')
+        .version(process.env.npm_package_version || '1.0.0')
+        .argument('[project-directory]', 'Project directory name')
+        .option('-h, --help', 'Show all available options')
+        .option('-e, --example <name-or-url>', 'An example to bootstrap the app with')
+        .option('--example-path <path>', 'Specify the path to the example separately')
+        .option('--use-npm', 'Explicitly tell the CLI to bootstrap using npm')
+        .option('--use-pnpm', 'Explicitly tell the CLI to bootstrap using pnpm')
+        .option('--use-yarn', 'Explicitly tell the CLI to bootstrap using yarn')
+        .option('--use-bun', 'Explicitly tell the CLI to bootstrap using bun')
+        .option('--use-deno', 'Explicitly tell the CLI to bootstrap using deno')
+        .option('--skip-install', 'Explicitly tell the CLI to skip installing packages')
+        .option('--no-git', 'Explicitly tell the CLI to disable git initialization')
+        .option('--yes', 'Use previous preferences or defaults for all options')
+        .option('--list-examples', 'List all available examples from the official repository');
+    program.parse();
+    const options = program.opts();
+    const args = program.args;
+    return {
+        help: options.help,
+        example: options.example,
+        examplePath: options.examplePath,
+        useNpm: options.useNpm,
+        usePnpm: options.usePnpm,
+        useYarn: options.useYarn,
+        useBun: options.useBun,
+        useDeno: options.useDeno,
+        skipInstall: options.skipInstall,
+        noGit: options.noGit,
+        yes: options.yes,
+        listExamples: options.listExamples,
+        projectDirectory: args[0],
+    };
+}

package/dist/functions/fetchExample.d.ts

@@ -0,0 +1,6 @@
+export interface FetchExampleOptions {
+    example: string;
+    examplePath?: string;
+    targetDir: string;
+}
+export declare function fetchExample({ example, examplePath, targetDir, }: FetchExampleOptions): Promise<void>;

package/dist/functions/fetchExample.js

@@ -0,0 +1,63 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+// @ts-ignore
+import tiged from 'tiged';
+import { validateExampleName } from './validate.js';
+export async function fetchExample({ example, examplePath, targetDir, }) {
+    const validation = validateExampleName(example);
+    if (!validation.valid) {
+        throw new Error(validation.error);
+    }
+    let sourceUrl;
+    // Check if it's a GitHub URL
+    if (example.startsWith('http://') || example.startsWith('https://')) {
+        sourceUrl = example;
+    }
+    else {
+        // Construct URL for curated examples
+        sourceUrl = `underctrl-io/commandkit/examples/${example}`;
+    }
+    // Create temporary directory for download
+    const tempDir = path.join(targetDir, '.temp-example');
+    try {
+        // Download the example
+        const emitter = tiged(sourceUrl, {
+            mode: 'tar',
+            disableCache: true,
+        });
+        await emitter.clone(tempDir);
+        // If examplePath is specified, navigate to that subdirectory
+        const sourceDir = examplePath ? path.join(tempDir, examplePath) : tempDir;
+        if (examplePath && !fs.existsSync(sourceDir)) {
+            throw new Error(`Example path '${examplePath}' not found in the repository`);
+        }
+        // Copy contents to target directory
+        const contents = fs.readdirSync(sourceDir);
+        for (const item of contents) {
+            const srcPath = path.join(sourceDir, item);
+            const destPath = path.join(targetDir, item);
+            if (fs.statSync(srcPath).isDirectory()) {
+                await fs.copy(srcPath, destPath);
+            }
+            else {
+                await fs.copy(srcPath, destPath);
+            }
+        }
+        // Clean up temporary directory
+        await fs.remove(tempDir);
+    }
+    catch (error) {
+        // Clean up on error
+        if (fs.existsSync(tempDir)) {
+            await fs.remove(tempDir);
+        }
+        if (error instanceof Error) {
+            if (error.message.includes('not found') ||
+                error.message.includes('404')) {
+                throw new Error(`Example '${example}' not found. Available examples: basic-ts, basic-js, deno-ts, without-cli`);
+            }
+            throw new Error(`Failed to fetch example: ${error.message}`);
+        }
+        throw new Error('Failed to fetch example due to an unknown error');
+    }
+}

package/dist/functions/validate.d.ts

@@ -0,0 +1,12 @@
+export declare function validateProjectName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare function validateDirectory(dir: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare function validateExampleName(example: string): {
+    valid: boolean;
+    error?: string;
+};

package/dist/functions/validate.js

@@ -0,0 +1,70 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import validateNpmPackageName from 'validate-npm-package-name';
+export function validateProjectName(name) {
+    const result = validateNpmPackageName(name);
+    if (!result.validForNewPackages) {
+        const errors = result.errors || [];
+        const warnings = result.warnings || [];
+        const allIssues = [...errors, ...warnings];
+        return {
+            valid: false,
+            error: allIssues.length > 0 ? allIssues[0] : 'Invalid project name',
+        };
+    }
+    return { valid: true };
+}
+export function validateDirectory(dir) {
+    const resolvedDir = path.resolve(process.cwd(), dir);
+    try {
+        const exists = fs.existsSync(resolvedDir);
+        if (!exists) {
+            return { valid: true };
+        }
+        const contents = fs.readdirSync(resolvedDir);
+        const isEmpty = contents.length === 0;
+        if (!isEmpty) {
+            return {
+                valid: false,
+                error: 'Directory is not empty!',
+            };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: 'Unable to access directory',
+        };
+    }
+}
+export function validateExampleName(example) {
+    // Check if it's a GitHub URL
+    if (example.startsWith('http://') || example.startsWith('https://')) {
+        try {
+            const url = new URL(example);
+            if (url.hostname === 'github.com' || url.hostname === 'www.github.com') {
+                return { valid: true };
+            }
+            return {
+                valid: false,
+                error: 'Only GitHub URLs are supported',
+            };
+        }
+        catch {
+            return {
+                valid: false,
+                error: 'Invalid URL format',
+            };
+        }
+    }
+    // Check if it's a valid example name (alphanumeric, hyphens, underscores)
+    const exampleNameRegex = /^[a-zA-Z0-9-_]+$/;
+    if (!exampleNameRegex.test(example)) {
+        return {
+            valid: false,
+            error: 'Example name can only contain letters, numbers, hyphens, and underscores',
+        };
+    }
+    return { valid: true };
+}

package/dist/index.js

@@ -1,100 +1,197 @@
 #!/usr/bin/env node
-console.clear();
-import { confirm, intro, outro, password, select, text } from '@clack/prompts';
+import { confirm, intro, outro, password, text } from '@clack/prompts';
 import fs from 'fs-extra';
 import gradient from 'gradient-string';
 import { execSync } from 'node:child_process';
-import path from 'node:path';
+import path, { join } from 'node:path';
 import colors from 'picocolors';
-import { copyTemplates } from './functions/copyTemplates.js';
-import { installDeps } from './functions/installDeps.js';
-import { setup } from './functions/setup.js';
-import { detectPackageManager, textColors } from './utils.js';
-const commandkitGradient = gradient(textColors.commandkit)('CommandKit');
-intro(`Welcome to ${commandkitGradient}!`);
-const dir = path.resolve(process.cwd(), (await text({
-    message: 'Enter a project directory:',
-    placeholder: 'Leave blank for current directory',
-    defaultValue: '.',
-    validate: (value) => {
-        value = path.resolve(process.cwd(), value);
-        let isEmpty;
+import { parseCLI } from './cli.js';
+import { fetchExample } from './functions/fetchExample.js';
+import { validateDirectory, validateProjectName, } from './functions/validate.js';
+import { fetchAvailableExamples, getDefaultExample, getInstallCommand, isOfficialExample, resolvePackageManager, textColors, } from './utils.js';
+import { readFile } from 'node:fs/promises';
+async function main() {
+    const cliOptions = parseCLI();
+    // Handle help and version flags
+    if (cliOptions.help) {
+        console.log(`
+Usage: create-commandkit [options] [project-directory]
+
+Options:
+  -h, --help                    Show all available options
+  -V, --version                 Output the version number
+  -e, --example <name-or-url>  An example to bootstrap the app with
+  --example-path <path>        Specify the path to the example separately
+  --use-npm                    Explicitly tell the CLI to bootstrap using npm
+  --use-pnpm                   Explicitly tell the CLI to bootstrap using pnpm
+  --use-yarn                   Explicitly tell the CLI to bootstrap using yarn
+  --use-bun                    Explicitly tell the CLI to bootstrap using bun
+  --use-deno                   Explicitly tell the CLI to bootstrap using deno
+  --skip-install               Explicitly tell the CLI to skip installing packages
+  --no-git                     Explicitly tell the CLI to disable git initialization
+  --yes                        Use previous preferences or defaults for all options
+  --list-examples              List all available examples from the official repository
+
+Examples:
+  npx create-commandkit@latest
+  npx create-commandkit@latest my-bot
+  npx create-commandkit@latest --example basic-ts
+  npx create-commandkit@latest --example "https://github.com/user/repo" --example-path "examples/bot"
+  npx create-commandkit@latest --use-pnpm --yes
+  npx create-commandkit@latest --list-examples
+`);
+        process.exit(0);
+    }
+    // Handle list examples flag
+    if (cliOptions.listExamples) {
+        console.log(colors.cyan('Fetching available examples...'));
         try {
-            const contents = fs.readdirSync(value);
-            isEmpty = contents.length === 0;
+            const examples = await fetchAvailableExamples();
+            console.log(colors.green('\nAvailable examples:'));
+            console.log('');
+            for (const example of examples) {
+                console.log(`  ${colors.magenta(example)}`);
+            }
+            console.log('');
+            console.log(colors.gray('Usage: npx create-commandkit@latest --example <example-name>'));
+            console.log(colors.gray('Example: npx create-commandkit@latest --example basic-ts'));
         }
-        catch {
-            isEmpty = true;
+        catch (error) {
+            console.error(colors.red('Failed to fetch examples list. Please check your internet connection.'));
+            process.exit(1);
         }
-        return isEmpty ? undefined : 'Directory is not empty!';
-    },
-})));
-const manager = (await select({
-    message: 'Select a package manager:',
-    initialValue: detectPackageManager(),
-    options: [
-        { label: 'npm', value: 'npm' },
-        { label: 'pnpm', value: 'pnpm' },
-        { label: 'yarn', value: 'yarn' },
-        { label: 'bun', value: 'bun' },
-        { label: 'deno', value: 'deno' },
-    ],
-}));
-const lang = (await select({
-    message: 'Select the language to use:',
-    initialValue: 'ts',
-    options: [
-        { label: 'TypeScript', value: 'ts' },
-        { label: 'JavaScript', value: 'js' },
-    ],
-}));
-const token = (await password({
-    message: 'Enter your Discord bot token (stored in .env, optional):',
-    mask: colors.gray('*'),
-}));
-const gitInit = await confirm({
-    message: 'Initialize a git repository?',
-    initialValue: true,
-});
-outro(colors.cyan('Setup complete.'));
-await setup({
-    manager,
-    dir,
-    token,
-});
-await copyTemplates({ dir, lang });
-if (gitInit) {
+        process.exit(0);
+    }
+    const commandkitGradient = gradient(textColors.commandkit)('CommandKit');
+    intro(`Welcome to ${commandkitGradient}!`);
+    // Determine project directory
+    let projectDir;
+    if (cliOptions.projectDirectory) {
+        projectDir = path.resolve(process.cwd(), cliOptions.projectDirectory);
+        // Validate project name if provided
+        const projectName = path.basename(projectDir);
+        const nameValidation = validateProjectName(projectName);
+        if (!nameValidation.valid) {
+            console.error(colors.red(`Error: ${nameValidation.error}`));
+            process.exit(1);
+        }
+    }
+    else if (cliOptions.yes) {
+        projectDir = path.resolve(process.cwd(), 'commandkit-project');
+    }
+    else {
+        projectDir = path.resolve(process.cwd(), (await text({
+            message: 'Enter a project directory:',
+            placeholder: 'Leave blank for current directory',
+            defaultValue: '.',
+            validate: (value) => {
+                value = path.resolve(process.cwd(), value);
+                const validation = validateDirectory(value);
+                return validation.valid ? undefined : validation.error;
+            },
+        })));
+    }
+    // Validate directory
+    const dirValidation = validateDirectory(projectDir);
+    if (!dirValidation.valid) {
+        console.error(colors.red(`Error: ${dirValidation.error}`));
+        process.exit(1);
+    }
+    // Determine package manager
+    const manager = resolvePackageManager(cliOptions);
+    // Get Discord token
+    let token;
+    if (cliOptions.yes) {
+        token = '';
+    }
+    else {
+        token = (await password({
+            message: 'Enter your Discord bot token (stored in .env, optional):',
+            mask: colors.gray('*'),
+        }));
+    }
+    // Determine git initialization
+    const gitInit = cliOptions.noGit
+        ? false
+        : cliOptions.yes
+            ? true
+            : await confirm({
+                message: 'Initialize a git repository?',
+                initialValue: true,
+            });
+    outro(colors.cyan('Setup complete.'));
+    // Fetch example from GitHub
     try {
-        execSync('git init', { cwd: dir, stdio: 'pipe' });
+        const example = cliOptions.example || getDefaultExample(cliOptions);
+        await fetchExample({
+            example,
+            examplePath: cliOptions.examplePath,
+            targetDir: projectDir,
+        });
+        // Create .env file with token
+        await fs.writeFile(`${projectDir}/.env`, `DISCORD_TOKEN="${token || ''}"`);
+        // Install packages for official examples
+        if (isOfficialExample(example) && !cliOptions.skipInstall) {
+            console.log(colors.cyan('Installing dependencies for official example...'));
+            try {
+                const tagMap = [
+                    ['-dev.', 'dev'],
+                    ['-rc.', 'next'],
+                ];
+                const tag = await readFile(join(import.meta.dirname, '..', 'package.json'), 'utf-8')
+                    .then((data) => {
+                    const version = JSON.parse(data).version;
+                    return (tagMap.find(([suffix]) => version.includes(suffix))?.[1] ||
+                        'latest');
+                })
+                    .catch(() => 'latest');
+                // Install dependencies
+                const depsCommand = getInstallCommand(manager, [
+                    `commandkit@${tag}`,
+                    'discord.js',
+                ]);
+                execSync(depsCommand, { cwd: projectDir, stdio: 'pipe' });
+                // Install dev dependencies
+                const devDepsCommand = getInstallCommand(manager, ['typescript', '@types/node'], true);
+                execSync(devDepsCommand, { cwd: projectDir, stdio: 'pipe' });
+                console.log(colors.green('Dependencies installed successfully!'));
+            }
+            catch (error) {
+                console.log(colors.yellow('Warning: Failed to install dependencies. You may need to install them manually.'));
+            }
+        }
     }
     catch (error) {
-        console.log(colors.yellow('Warning: Git initialization failed. Make sure Git is installed on your system.'));
+        console.error(colors.red(`Error fetching example: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        process.exit(1);
     }
-}
-installDeps({
-    dir,
-    manager,
-    lang,
-    stdio: 'pipe',
-});
-const command = (cmd) => {
-    switch (manager) {
-        case 'npm':
-        // bun build runs bundler instead of the build script
-        case 'bun':
-            return `${manager} run ${cmd}`;
-        case 'pnpm':
-        case 'yarn':
-            return `${manager} ${cmd}`;
-        case 'deno':
-            return `deno task ${cmd}`;
-        default:
-            return manager;
+    // Initialize git if requested
+    if (gitInit) {
+        try {
+            execSync('git init', { cwd: projectDir, stdio: 'pipe' });
+        }
+        catch (error) {
+            console.log(colors.yellow('Warning: Git initialization failed. Make sure Git is installed on your system.'));
+        }
     }
-};
-console.log(`${gradient(textColors.commandkit)('Thank you for choosing CommandKit!')}
+    const command = (cmd) => {
+        switch (manager) {
+            case 'npm':
+            // bun build runs bundler instead of the build script
+            case 'bun':
+                return `${manager} run ${cmd}`;
+            case 'pnpm':
+            case 'yarn':
+                return `${manager} ${cmd}`;
+            case 'deno':
+                return `deno task ${cmd}`;
+            default:
+                return manager;
+        }
+    };
+    console.log(`${gradient(textColors.commandkit)('Thank you for choosing CommandKit!')}
 
-To start your bot, use the following commands:
+To start your bot${projectDir !== '.' ? `, ${colors.magenta(`cd ${projectDir}`)}` : ''}${projectDir !== '.' ? ' and' : ''} use the following commands:
   ${colors.magenta(command('dev'))}     - Run your bot in development mode
   ${colors.magenta(command('build'))}   - Build your bot for production
   ${colors.magenta(command('start'))}   - Run your bot in production mode
@@ -105,3 +202,8 @@ To start your bot, use the following commands:
 • Discord community: ${colors.blue('https://ctrl.lol/discord')}
 
 Happy coding! 🚀`);
+}
+main().catch((error) => {
+    console.error(colors.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    process.exit(1);
+});

package/dist/types.d.ts

@@ -1,2 +1,16 @@
-export type Language = 'js' | 'ts';
 export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'deno';
+export interface CLIOptions {
+    help?: boolean;
+    example?: string;
+    examplePath?: string;
+    useNpm?: boolean;
+    usePnpm?: boolean;
+    useYarn?: boolean;
+    useBun?: boolean;
+    useDeno?: boolean;
+    skipInstall?: boolean;
+    noGit?: boolean;
+    yes?: boolean;
+    listExamples?: boolean;
+    projectDirectory?: string;
+}

package/dist/utils.d.ts

@@ -1,13 +1,25 @@
-import type { PackageManager } from './types';
+import type { CLIOptions, PackageManager } from './types';
 export declare const textColors: {
     commandkit: string[];
     js: string[];
     ts: string[];
 };
-export declare const commands: {
-    init: {
-        yarn: string;
-    };
-};
 export declare function detectPackageManager(): PackageManager;
-export declare function getCommandKitVersion(): string;
+export declare function getPackageManagerFromCLI(options: {
+    useNpm?: boolean;
+    usePnpm?: boolean;
+    useYarn?: boolean;
+    useBun?: boolean;
+    useDeno?: boolean;
+}): PackageManager | null;
+export declare function resolvePackageManager(cliOptions: {
+    useNpm?: boolean;
+    usePnpm?: boolean;
+    useYarn?: boolean;
+    useBun?: boolean;
+    useDeno?: boolean;
+}): PackageManager;
+export declare function getDefaultExample(cliOptions: CLIOptions): string;
+export declare function isOfficialExample(example: string): boolean;
+export declare function getInstallCommand(manager: PackageManager, deps: string[], dev?: boolean): string;
+export declare function fetchAvailableExamples(): Promise<string[]>;

package/dist/utils.js

@@ -1,16 +1,8 @@
-import fs from 'fs-extra';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 export const textColors = {
     commandkit: ['#fdba74', '#e4a5a2', '#c288de', '#b27bf9'],
     js: ['#f7e01c', '#f7e01c'],
     ts: ['#2480c5', '#2480c5'],
 };
-export const commands = {
-    init: {
-        yarn: 'yarn set version stable; yarn config set nodeLinker node-modules;',
-    },
-};
 export function detectPackageManager() {
     const packageManager = process.env.npm_config_user_agent;
     if (packageManager?.includes('pnpm'))
@@ -25,25 +17,92 @@ export function detectPackageManager() {
         return 'deno';
     return 'npm';
 }
-export function getCommandKitVersion() {
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = path.dirname(__filename);
-        const packageJsonPath = path.resolve(__dirname, '..', 'package.json');
-        const packageJson = fs.readJsonSync(packageJsonPath);
-        const currentVersion = packageJson.version;
-        if (currentVersion.includes('dev.')) {
-            return '@dev';
+export function getPackageManagerFromCLI(options) {
+    if (options.useNpm)
+        return 'npm';
+    if (options.usePnpm)
+        return 'pnpm';
+    if (options.useYarn)
+        return 'yarn';
+    if (options.useBun)
+        return 'bun';
+    if (options.useDeno)
+        return 'deno';
+    return null;
+}
+export function resolvePackageManager(cliOptions) {
+    const cliManager = getPackageManagerFromCLI(cliOptions);
+    return cliManager || detectPackageManager();
+}
+export function getDefaultExample(cliOptions) {
+    if (cliOptions.useDeno) {
+        return 'deno-ts';
+    }
+    return 'basic-ts';
+}
+export function isOfficialExample(example) {
+    // Check if it's a GitHub URL pointing to underctrl-io/commandkit
+    if (example.startsWith('http://') || example.startsWith('https://')) {
+        try {
+            const url = new URL(example);
+            return (url.hostname === 'github.com' &&
+                url.pathname.startsWith('/underctrl-io/commandkit'));
         }
-        else if (currentVersion.includes('rc.')) {
-            return '@next';
+        catch {
+            return false;
         }
-        else {
-            return '@latest';
+    }
+    // If it's just an example name, it's official
+    return true;
+}
+export function getInstallCommand(manager, deps, dev = false) {
+    switch (manager) {
+        case 'npm':
+        case 'pnpm':
+        case 'yarn':
+        case 'bun':
+            return `${manager} add ${dev ? '-D' : ''} ${deps.join(' ')}`;
+        case 'deno':
+            return `deno add ${dev ? '--dev' : ''} ${deps.map((d) => `npm:${d}`).join(' ')}`;
+        default:
+            return manager;
+    }
+}
+export async function fetchAvailableExamples() {
+    let controller = null;
+    let timeoutId = null;
+    try {
+        controller = new AbortController();
+        timeoutId = setTimeout(() => controller.abort(), 10000); // 10 second timeout
+        const response = await fetch('https://api.github.com/repos/underctrl-io/commandkit/contents/examples', {
+            signal: controller.signal,
+            headers: {
+                'User-Agent': 'create-commandkit',
+            },
+        });
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        if (!response.ok) {
+            throw new Error(`GitHub API error: ${response.status}`);
         }
+        const data = (await response.json());
+        // Filter for directories only and return their names
+        return data
+            .filter((item) => item.type === 'dir')
+            .map((item) => item.name)
+            .sort();
     }
     catch (error) {
-        console.warn('Could not determine create-commandkit version, defaulting to commandkit@latest');
-        return '@latest';
+        // Clean up on error
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        if (controller) {
+            controller.abort();
+        }
+        // Fallback to few known examples if API fails
+        return ['basic-ts', 'basic-js', 'deno-ts', 'without-cli'];
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-commandkit",
   "description": "Effortlessly create a CommandKit project",
-  "version": "1.2.0-dev.20251019020542",
+  "version": "1.2.0-dev.20251019062347",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "bin": "./dist/index.js",
@@ -18,8 +18,7 @@
     "commands"
   ],
   "files": [
-    "dist",
-    "templates"
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -29,21 +28,26 @@
   "homepage": "https://commandkit.dev",
   "dependencies": {
     "@clack/prompts": "^0.11.0",
+    "commander": "^14.0.1",
     "fs-extra": "^11.1.1",
     "gradient-string": "^3.0.0",
     "ora": "^8.0.1",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "tiged": "^2.12.7",
+    "validate-npm-package-name": "^6.0.2"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
     "@types/gradient-string": "^1.1.5",
     "@types/node": "^22.0.0",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "tsx": "^4.20.6",
     "typescript": "^5.8.3",
-    "tsconfig": "0.0.0-dev.20251019020542"
+    "tsconfig": "0.0.0-dev.20251019062347"
   },
   "scripts": {
     "check-types": "tsc --noEmit",
     "dev": "tsc --watch",
-    "build": "tsc"
+    "build": "tsc && tsx scripts/sync-available-examples.ts"
   }
 }

package/dist/functions/copyTemplates.d.ts

@@ -1,5 +0,0 @@
-import type { Language } from '../types';
-export declare function copyTemplates({ dir, lang, }: {
-    lang: Language;
-    dir: string;
-}): Promise<void>;

package/dist/functions/copyTemplates.js

@@ -1,47 +0,0 @@
-import fs from 'fs-extra';
-import path from 'node:path';
-const templates = {
-    js: path.join(import.meta.dirname, '..', '..', 'templates', 'JavaScript'),
-    ts: path.join(import.meta.dirname, '..', '..', 'templates', 'TypeScript'),
-};
-const gitignore = `
-# dependencies
-node_modules
-
-# build output
-build
-out
-dist
-
-# commandkit
-.commandkit
-dist
-compiled-commandkit.config.mjs
-
-# env
-**/*.env*
-!**/*.env.example*
-
-# logging
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-.pnpm-debug.log*
-
-# yarn v2+
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-# other
-**/*.DS_Store
-`;
-export async function copyTemplates({ dir, lang, }) {
-    await fs.copy(templates[lang], dir);
-    await fs.writeFile(path.join(dir, '.gitignore'), gitignore);
-}

package/dist/functions/installDeps.d.ts

@@ -1,10 +0,0 @@
-import { type IOType } from 'node:child_process';
-import type { Language, PackageManager } from '../types';
-interface InstallDepsProps {
-    manager: PackageManager;
-    dir: string;
-    lang: Language;
-    stdio: IOType;
-}
-export declare function installDeps({ manager, dir, lang, stdio, }: InstallDepsProps): void;
-export {};

package/dist/functions/installDeps.js

@@ -1,49 +0,0 @@
-import { execSync } from 'node:child_process';
-import ora from 'ora';
-import { getCommandKitVersion } from '../utils.js';
-const getBaseDependencies = () => [
-    `commandkit${getCommandKitVersion()}`,
-    'discord.js',
-];
-const getDependencies = () => ({
-    js: {
-        dependencies: getBaseDependencies(),
-        devDependencies: ['@types/node', 'typescript', 'prettier'],
-    },
-    ts: {
-        dependencies: getBaseDependencies(),
-        devDependencies: ['@types/node', 'typescript', 'prettier'],
-    },
-});
-function getInstallCommand(manager, deps, dev = false) {
-    switch (manager) {
-        case 'npm':
-        case 'pnpm':
-        case 'yarn':
-        case 'bun':
-            return `${manager} add ${dev ? '-D' : ''} ${deps.join(' ')}`;
-        case 'deno':
-            return `deno add ${dev ? '--dev' : ''} ${deps.map((d) => `npm:${d}`).join(' ')}`;
-        default:
-            return manager;
-    }
-}
-export function installDeps({ manager, dir, lang, stdio = 'inherit', }) {
-    const spinner = ora('Installing dependencies...').start();
-    try {
-        const dependencies = getDependencies();
-        if (dependencies[lang].dependencies.length) {
-            const depsCommand = getInstallCommand(manager, dependencies[lang].dependencies);
-            execSync(depsCommand, { cwd: dir, stdio });
-        }
-        if (dependencies[lang].devDependencies.length) {
-            const devDepsCommand = getInstallCommand(manager, dependencies[lang].devDependencies, true);
-            execSync(devDepsCommand, { cwd: dir, stdio });
-        }
-        spinner.succeed('Dependencies installed successfully!');
-    }
-    catch (error) {
-        spinner.fail('Failed to install dependencies');
-        throw error;
-    }
-}

package/dist/functions/setup.d.ts

@@ -1,10 +0,0 @@
-import { type IOType } from 'child_process';
-import type { PackageManager } from '../types';
-interface SetupProps {
-    manager: PackageManager;
-    token: string;
-    dir: string;
-    stdio?: IOType;
-}
-export declare function setup({ manager, token, dir, stdio, }: SetupProps): Promise<void>;
-export {};

package/dist/functions/setup.js

@@ -1,68 +0,0 @@
-import { execSync } from 'child_process';
-import fs from 'fs-extra';
-import path from 'node:path';
-import { commands } from '../utils.js';
-export async function setup({ manager, token, dir, stdio = 'pipe', }) {
-    await fs.emptyDir(dir);
-    if (manager === 'yarn') {
-        execSync(commands.init.yarn, { cwd: dir, stdio });
-    }
-    if (manager === 'deno') {
-        const denoJsonPath = path.join(dir, 'deno.json');
-        const denoJson = {
-            compilerOptions: {
-                jsx: 'react-jsx',
-                jsxImportSource: 'commandkit',
-            },
-            nodeModulesDir: 'auto',
-            lock: true,
-            lint: {
-                include: ['src/'],
-                exclude: ['node_modules/', 'dist/', '.commandkit/'],
-            },
-            fmt: {
-                useTabs: false,
-                lineWidth: 120,
-                indentWidth: 2,
-                endOfLine: 'lf',
-                semiColons: true,
-                singleQuote: true,
-                include: ['src/'],
-                exclude: ['node_modules/', 'dist/', '.commandkit/'],
-            },
-        };
-        await fs.writeJSON(denoJsonPath, denoJson, { spaces: 2, EOL: '\n' });
-    }
-    const prettierrc = path.join(dir, '.prettierrc');
-    const prettierConfig = {
-        printWidth: 120,
-        tabWidth: 2,
-        useTabs: false,
-        semi: true,
-        endOfLine: 'lf',
-        singleQuote: true,
-        trailingComma: 'all',
-        arrowParens: 'always',
-    };
-    await fs.writeJSON(prettierrc, prettierConfig, { spaces: 2, EOL: '\n' });
-    const packageJsonPath = path.join(dir, 'package.json');
-    const packageJson = {
-        name: dir.replaceAll('\\', '/').split('/').pop()?.toLowerCase() ||
-            'commandkit-project',
-        description: 'A CommandKit project',
-        version: '0.1.0',
-        type: 'module',
-        private: true,
-        main: 'dist/index.js',
-        scripts: {
-            dev: 'commandkit dev',
-            build: 'commandkit build',
-            start: 'commandkit start',
-            format: 'prettier --write "src/**/*.{js,ts}"',
-        },
-        devDependencies: {},
-        dependencies: {},
-    };
-    await fs.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
-    await fs.writeFile(`${dir}/.env`, `DISCORD_TOKEN="${token || ''}"`);
-}

package/templates/JavaScript/README.md

@@ -1,16 +0,0 @@
-# Welcome to CommandKit
-
-> This project was generated by [create-commandkit](https://npmjs.com/package/create-commandkit).
-
-Thanks for choosing CommandKit to build your Discord bot!
-
-## To run this project
-
-```
-npx commandkit dev
-```
-
-## Useful links
-
--   [Documentation](https://commandkit.dev)
--   [Discord](https://ctrl.lol/discord)

package/templates/JavaScript/commandkit-env.d.ts

@@ -1 +0,0 @@
-/// <reference path="node_modules/commandkit-types/index.d.ts" />

package/templates/JavaScript/commandkit.config.mjs

@@ -1,3 +0,0 @@
-import { defineConfig } from 'commandkit/config';
-
-export default defineConfig({});

package/templates/JavaScript/jsconfig.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "compilerOptions": {
-    "lib": ["ESNext", "DOM"],
-    "target": "ESNext",
-    "moduleResolution": "Node",
-    "module": "Preserve",
-    "allowImportingTsExtensions": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "noUncheckedIndexedAccess": true,
-    "removeComments": true,
-    "allowJs": true,
-    "checkJs": false,
-    "strict": true,
-    "alwaysStrict": true,
-    "noEmit": true,
-    "declaration": false,
-    "jsx": "react-jsx",
-    "jsxImportSource": "commandkit",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src", "commandkit.config.mjs", "commandkit-env.d.ts"],
-  "exclude": ["dist", "node_modules", ".commandkit"]
-}

package/templates/JavaScript/src/app/commands/ping.js

@@ -1,27 +0,0 @@
-/**
- * @type {import('commandkit').CommandData}
- */
-export const command = {
-  name: 'ping',
-  description: "Ping the bot to check if it's online.",
-};
-
-/**
- * @param {import('commandkit').ChatInputCommandContext} ctx
- */
-export const chatInput = async (ctx) => {
-  const latency = (ctx.client.ws.ping ?? -1).toString();
-  const response = `Pong! Latency: ${latency}ms`;
-
-  await ctx.interaction.reply(response);
-};
-
-/**
- * @param {import('commandkit').MessageCommandContext} ctx
- */
-export const message = async (ctx) => {
-  const latency = (ctx.client.ws.ping ?? -1).toString();
-  const response = `Pong! Latency: ${latency}ms`;
-
-  await ctx.message.reply(response);
-};

package/templates/JavaScript/src/app/events/clientReady/log.js

@@ -1,10 +0,0 @@
-import { Logger } from 'commandkit/logger';
-
-/**
- * @type {import('commandkit').EventHandler<'clientReady'>}
- */
-const handler = async (client) => {
-  Logger.info(`Logged in as ${client.user.username}!`);
-};
-
-export default handler;

package/templates/JavaScript/src/app.js

@@ -1,7 +0,0 @@
-import { Client } from 'discord.js';
-
-const client = new Client({
-  intents: ['Guilds', 'GuildMembers', 'GuildMessages', 'MessageContent'],
-});
-
-export default client;

package/templates/TypeScript/README.md

@@ -1,16 +0,0 @@
-# Welcome to CommandKit
-
-> This project was generated by [create-commandkit](https://npmjs.com/package/create-commandkit).
-
-Thanks for choosing CommandKit to build your Discord bot!
-
-## To run this project
-
-```
-npx commandkit dev
-```
-
-## Useful links
-
--   [Documentation](https://commandkit.dev)
--   [Discord](https://ctrl.lol/discord)

package/templates/TypeScript/commandkit-env.d.ts

@@ -1 +0,0 @@
-/// <reference path="node_modules/commandkit-types/index.d.ts" />

package/templates/TypeScript/commandkit.config.ts

@@ -1,3 +0,0 @@
-import { defineConfig } from 'commandkit/config';
-
-export default defineConfig({});

package/templates/TypeScript/src/app/commands/ping.ts

@@ -1,20 +0,0 @@
-import type { ChatInputCommand, MessageCommand, CommandData } from 'commandkit';
-
-export const command: CommandData = {
-  name: 'ping',
-  description: "Ping the bot to check if it's online.",
-};
-
-export const chatInput: ChatInputCommand = async (ctx) => {
-  const latency = (ctx.client.ws.ping ?? -1).toString();
-  const response = `Pong! Latency: ${latency}ms`;
-
-  await ctx.interaction.reply(response);
-};
-
-export const message: MessageCommand = async (ctx) => {
-  const latency = (ctx.client.ws.ping ?? -1).toString();
-  const response = `Pong! Latency: ${latency}ms`;
-
-  await ctx.message.reply(response);
-};

package/templates/TypeScript/src/app/events/clientReady/log.ts

@@ -1,8 +0,0 @@
-import type { EventHandler } from 'commandkit';
-import { Logger } from 'commandkit/logger';
-
-const handler: EventHandler<'clientReady'> = async (client) => {
-  Logger.info(`Logged in as ${client.user.username}!`);
-};
-
-export default handler;

package/templates/TypeScript/src/app.ts

@@ -1,7 +0,0 @@
-import { Client } from 'discord.js';
-
-const client = new Client({
-  intents: ['Guilds', 'GuildMembers', 'GuildMessages', 'MessageContent'],
-});
-
-export default client;

package/templates/TypeScript/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "compilerOptions": {
-    "lib": ["ESNext", "DOM"],
-    "target": "ESNext",
-    "moduleResolution": "Node",
-    "module": "Preserve",
-    "allowImportingTsExtensions": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "noUncheckedIndexedAccess": true,
-    "removeComments": true,
-    "allowJs": true,
-    "strict": true,
-    "alwaysStrict": true,
-    "noEmit": true,
-    "declaration": false,
-    "jsx": "react-jsx",
-    "jsxImportSource": "commandkit",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src", "commandkit.config.ts", "commandkit-env.d.ts"],
-  "exclude": ["dist", "node_modules", ".commandkit"]
-}