directus-template-cli 0.7.0-beta.8 → 0.7.0

package/README.md

@@ -1,17 +1,17 @@
 # Directus Template CLI
 
-A streamlined CLI tool for managing Directus templates - making it easy to apply and extract template configurations across instances.
+A streamlined CLI tool for creating new Directus projects and managing Directus templates - making it easy to apply and extract template configurations across instances.
 
-⚠️ **Beta Release Notice**: This tool is currently in beta and best suited for:
+This tool is best suited for:
 - Proof of Concept (POC) projects
 - Demo environments
 - New project setups
 
-We strongly recommend against using this tool in existing production environments or as a critical part of your CI/CD pipeline without thorough testing. Always create backups before applying templates.
+⚠️ We strongly recommend against using this tool in existing production environments or as a critical part of your CI/CD pipeline without thorough testing. Always create backups before applying templates.
 
 **Important Notes:**
 - **Primary Purpose**: Built to deploy templates created by the Directus Core Team. While community templates are supported, the unlimited possible configurations make comprehensive support challenging.
-- **Database Compatibility**: PostgreSQL and SQLite are recommended. MySQL users may encounter known issues.
+- **Database Compatibility**: PostgreSQL is recommended. Applying templates that are extracted and applied between different databases (Extract from SQLite ->  Apply to Postgres) can caused issues and is not recommended. MySQL users may encounter known issues.
 - **Performance**: Remote operations (extract/apply) are rate-limited to 10 requests/second using bottleneck. Processing time varies based on your instance size (collections, items, assets).
 - **Version Compatibility**:
   - v0.5.0+: Compatible with Directus 11 and up
@@ -19,6 +19,105 @@ We strongly recommend against using this tool in existing production environment
 
 Using the @latest tag ensures you're receiving the latest version of the packaged templates with the CLI. You can review [the specific versions on NPM](https://www.npmjs.com/package/directus-template-cli) and use @{version} syntax to apply the templates included with that version.
 
+## Initializing a New Project
+
+The CLI can initialize a new Directus project with an optional frontend framework using official or community templates.
+
+1. Run the following command and follow the interactive prompts:
+
+```
+npx directus-template-cli@latest init
+```
+
+You'll be guided through:
+- Selecting a directory for your new project
+- Choosing a Directus backend template
+- Selecting a frontend framework (if available for the template)
+- Setting up Git and installing dependencies
+
+### Command Options
+
+You can also provide arguments and flags:
+
+```
+npx directus-template-cli@latest init my-project
+```
+
+The first argument (`my-project` in the example above) specifies the directory where the project will be created. If not provided, you'll be prompted to enter a directory during the interactive process.
+
+```
+npx directus-template-cli@latest init --frontend=nextjs --template=cms
+npx directus-template-cli@latest init my-project --frontend=nextjs --template=cms
+npx directus-template-cli@latest init --template=https://github.com/directus-labs/starters/tree/main/cms
+```
+
+
+Available flags:
+
+- `--frontend`: Frontend framework to use (e.g., nextjs, nuxt, astro)
+- `--gitInit`: Initialize a new Git repository (defaults to true, use --no-gitInit to disable)
+- `--installDeps`: Install dependencies automatically (defaults to true, use --no-installDeps to disable)
+- `--overwriteDir`: Override the default directory if it already exists (defaults to false)
+- `--template`: Template name (e.g., simple-cms) or GitHub URL (e.g., https://github.com/directus-labs/starters/tree/main/cms)
+- `--disableTelemetry`: Disable telemetry collection
+
+You can use any public GitHub repository URL for the `--template` parameter, pointing to the specific directory containing the template. This is especially useful for using community-maintained templates or your own custom templates hosted on GitHub.
+
+### Creating Custom Templates
+
+You can create your own custom templates for use with the `init` command. A template is defined by a `package.json` file with a `directus:template` property that specifies the template configuration.
+
+NOTE: the `init` command will NOT work without this step of the process.
+
+Here's an example of a template configuration:
+
+```json
+{
+  "name": "directus-cms-starter",
+  "version": "1.0.0",
+  "description": "A starter template for Directus CMS projects",
+  "directus:template": {
+    "name": "CMS",
+    "description": "A ready-to-use CMS with block builder, visual editing, and integration with your favorite framework.",
+    "template": "./directus/template",
+    "frontends": {
+      "nextjs": {
+        "name": "Next.js",
+        "path": "./nextjs"
+      },
+      "nuxt": {
+        "name": "Nuxt",
+        "path": "./nuxt"
+      },
+      "astro": {
+        "name": "Astro",
+        "path": "./astro"
+      },
+      "svelte": {
+        "name": "Svelte",
+        "path": "./sveltekit"
+      }
+    }
+  }
+}
+```
+
+The `directus:template` property contains:
+
+- `name`: Display name for the template in the CLI
+- `description`: A brief description of the template's purpose and features
+- `template`: Path to the Directus template directory (containing schema, permissions, etc.) - this should point to a template extracted using the `extract` command
+- `frontends`: Object defining available frontend frameworks for this template
+  - Each key is a frontend identifier used with the `--frontend` flag
+  - Each frontend has a `name` (display name) and `path` (directory containing the frontend code)
+
+When you use this template with the `init` command, it will:
+1. Copy the Directus template files from the specified template directory
+2. Copy the selected frontend code based on your choice or the `--frontend` flag
+3. Set up the project structure with both backend and frontend integrated
+
+> **Note**: The template directory (`./directus/template` in the example above) should contain a valid Directus template created using the `extract` command. The directory structure should match what is created by the CLI when extracting a template, with subdirectories for schema, permissions, content, etc.
+
 ## Applying a Template
 
 🚧 Make backups of your project/database before applying templates.
@@ -59,7 +158,7 @@ npx directus-template-cli@latest apply -p --directusUrl="http://localhost:8055"
 
 ```
 
-Available flags for programmatic mode:
+Available flags:
 
 - `--directusUrl`: URL of the Directus instance to apply the template to (required)
 - `--directusToken`: Token to use for the Directus instance (required if not using email/password)
@@ -77,6 +176,7 @@ Available flags for programmatic mode:
 - `--schema`: Load Schema
 - `--settings`: Load Settings
 - `--users`: Load Users
+- `--disableTelemetry`: Disable telemetry collection
 
 When using `--partial`, you can also use `--no` flags to exclude specific components from being applied. For example:
 
@@ -130,7 +230,7 @@ You can also pass flags as environment variables. This can be useful for CI/CD p
 - `TARGET_DIRECTUS_PASSWORD`: Equivalent to `--userPassword`
 - `TEMPLATE_LOCATION`: Equivalent to `--templateLocation`
 - `TEMPLATE_TYPE`: Equivalent to `--templateType`
--
+
 
 ### Existing Data
 
@@ -142,7 +242,7 @@ In most of the system collections (collections,roles, permissions, etc.), if an
 
 Exceptions:
 
-- directus_settings: The CLI attempts to merge the template's project settings with the existing settings in the target instance. Using the existing settings as a base and updating them with the values from the template. This should prevent overwriting branding, themes, and other customizations.
+- `directus_settings`: The CLI attempts to merge the template's project settings with the existing settings in the target instance. Using the existing settings as a base and updating them with the values from the template. This should prevent overwriting branding, themes, and other customizations.
 
 **Your Collections:**
 
@@ -181,7 +281,7 @@ Using email/password:
 npx directus-template-cli@latest extract -p --templateName="My Template" --templateLocation="./my-template" --userEmail="admin@example.com" --userPassword="admin" --directusUrl="http://localhost:8055"
 ```
 
-Available flags for programmatic mode:
+Available flags:
 
 - `--directusUrl`: URL of the Directus instance to extract the template from (required)
 - `--directusToken`: Token to use for the Directus instance (required if not using email/password)
@@ -189,6 +289,7 @@ Available flags for programmatic mode:
 - `--userPassword`: Password for Directus authentication (required if not using token)
 - `--templateLocation`: Directory to extract the template to (required)
 - `--templateName`: Name of the template (required)
+- `--disableTelemetry`: Disable telemetry collection
 
 #### Using Environment Variables
 

package/dist/commands/apply.d.ts

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class ApplyCommand extends Command {
+import { BaseCommand } from './base.js';
+export default class ApplyCommand extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -20,6 +20,7 @@ export default class ApplyCommand extends Command {
         userEmail: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         userPassword: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         users: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disableTelemetry: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     /**
      * MAIN

package/dist/commands/apply.js

@@ -1,18 +1,21 @@
-import { Command, Flags, ux } from '@oclif/core';
-import { text, select, password, log, intro } from '@clack/prompts';
+import { Flags, ux } from '@oclif/core';
+import { text, select, log, intro } from '@clack/prompts';
 import * as path from 'pathe';
 import { animatedBunny } from '../lib/utils/animated-bunny.js';
 import * as customFlags from '../flags/common.js';
 import { DIRECTUS_PINK, DIRECTUS_PURPLE, SEPARATOR } from '../lib/constants.js';
 import { validateInteractiveFlags, validateProgrammaticFlags } from '../lib/load/apply-flags.js';
 import apply from '../lib/load/index.js';
-import { getDirectusToken, getDirectusUrl, initializeDirectusApi } from '../lib/utils/auth.js';
+import { getDirectusToken, getDirectusUrl, initializeDirectusApi, getDirectusEmailAndPassword } from '../lib/utils/auth.js';
 import catchError from '../lib/utils/catch-error.js';
 import { getCommunityTemplates, getGithubTemplate, getInteractiveLocalTemplate, getLocalTemplate } from '../lib/utils/get-template.js';
 import { logger } from '../lib/utils/logger.js';
 import openUrl from '../lib/utils/open-url.js';
 import chalk from 'chalk';
-export default class ApplyCommand extends Command {
+import { BaseCommand } from './base.js';
+import { track, shutdown } from '../services/posthog.js';
+import { BSL_LICENSE_HEADLINE, BSL_LICENSE_TEXT, BSL_LICENSE_CTA } from '../lib/constants.js';
+export default class ApplyCommand extends BaseCommand {
     static description = 'Apply a template to a blank Directus instance.';
     static examples = [
         '$ directus-template-cli apply',
@@ -85,6 +88,7 @@ export default class ApplyCommand extends Command {
             default: undefined,
             description: 'Load users',
         }),
+        disableTelemetry: customFlags.disableTelemetry,
     };
     /**
      * MAIN
@@ -164,21 +168,52 @@ export default class ApplyCommand extends Command {
             validatedFlags.directusToken = directusToken;
         }
         else {
-            const userEmail = await text({
-                message: 'What is your email?',
-            });
+            const { userEmail, userPassword } = await getDirectusEmailAndPassword();
             validatedFlags.userEmail = userEmail;
-            const userPassword = await password({
-                message: 'What is your password?',
-            });
             validatedFlags.userPassword = userPassword;
         }
         await initializeDirectusApi(validatedFlags);
         if (template) {
             // /* TODO: Replace with custom styledHeader function */ ux.styledHeader(ux.colorize(DIRECTUS_PURPLE, `Applying template - ${template.templateName} to ${directusUrl}`))
+            // Track start just before applying
+            if (!validatedFlags.disableTelemetry) {
+                await track({
+                    command: 'apply',
+                    lifecycle: 'start',
+                    distinctId: this.userConfig.distinctId,
+                    flags: {
+                        programmatic: false,
+                        templateName: template.templateName,
+                        templateType,
+                        // Include other relevant flags from validatedFlags if needed
+                        ...validatedFlags,
+                    },
+                    runId: this.runId,
+                    config: this.config,
+                });
+            }
             await apply(template.directoryPath, validatedFlags);
             ux.action.stop();
+            // Track completion before final messages/exit
+            if (!validatedFlags.disableTelemetry) {
+                await track({
+                    command: 'apply',
+                    lifecycle: 'complete',
+                    distinctId: this.userConfig.distinctId,
+                    flags: {
+                        templateName: template.templateName,
+                        templateType,
+                        ...validatedFlags,
+                    },
+                    runId: this.runId,
+                    config: this.config,
+                });
+                await shutdown();
+            }
             ux.stdout(SEPARATOR);
+            log.warn(BSL_LICENSE_HEADLINE);
+            log.info(BSL_LICENSE_TEXT);
+            log.info(BSL_LICENSE_CTA);
             ux.stdout('Template applied successfully.');
             ux.exit(0);
         }
@@ -216,10 +251,45 @@ export default class ApplyCommand extends Command {
         const logMessage = `Applying template - ${template.templateName} to ${validatedFlags.directusUrl}`;
         // /* TODO: Replace with custom styledHeader function */ ux.styledHeader(logMessage)
         logger.log('info', logMessage);
+        // Track start just before applying
+        if (!validatedFlags.disableTelemetry) {
+            await track({
+                command: 'apply',
+                lifecycle: 'start',
+                distinctId: this.userConfig.distinctId,
+                flags: {
+                    programmatic: true,
+                    templateName: template.templateName,
+                    // Include other relevant flags from validatedFlags
+                    ...validatedFlags,
+                },
+                runId: this.runId,
+                config: this.config,
+            });
+        }
         await apply(template.directoryPath, validatedFlags);
         ux.action.stop();
+        // Track completion before final messages/exit
+        if (!validatedFlags.disableTelemetry) {
+            await track({
+                command: 'apply',
+                lifecycle: 'complete',
+                distinctId: this.userConfig.distinctId,
+                flags: {
+                    templateName: template.templateName,
+                    // Include other relevant flags from validatedFlags
+                    ...validatedFlags,
+                },
+                runId: this.runId,
+                config: this.config,
+            });
+            await shutdown();
+        }
         ux.stdout(SEPARATOR);
         ux.stdout('Template applied successfully.');
+        log.warn(BSL_LICENSE_HEADLINE);
+        log.info(BSL_LICENSE_TEXT);
+        log.info(BSL_LICENSE_CTA);
         // ux.exit(0)
     }
     /**

package/dist/commands/base.d.ts

@@ -6,6 +6,7 @@ export declare abstract class BaseCommand extends Command {
     runId: string;
     userConfig: UserConfig;
     constructor(argv: string[], config: Config);
+    init(): Promise<void>;
     private loadUserConfig;
     /**
      * Save the current user configuration to disk

package/dist/commands/base.js

@@ -2,6 +2,7 @@ import { Command } from '@oclif/core';
 import { randomUUID } from 'node:crypto';
 import fs from 'node:fs';
 import path from 'pathe';
+import { setExecutionContext } from '../services/execution-context.js';
 export class BaseCommand extends Command {
     runId;
     userConfig = {};
@@ -10,6 +11,18 @@ export class BaseCommand extends Command {
         this.runId = randomUUID();
         this.loadUserConfig();
     }
+    async init() {
+        await super.init();
+        const { flags } = await this.parse({
+            flags: this.ctor.flags,
+            args: this.ctor.args,
+            strict: false,
+        });
+        setExecutionContext({
+            distinctId: this.userConfig.distinctId ?? undefined,
+            disableTelemetry: flags?.disableTelemetry ?? false,
+        });
+    }
     loadUserConfig() {
         try {
             const configPath = path.join(this.config.configDir, 'config.json');

package/dist/commands/extract.d.ts

@@ -1,4 +1,4 @@
-import { Command } from '@oclif/core';
+import { BaseCommand } from './base.js';
 export interface ExtractFlags {
     directusToken: string;
     directusUrl: string;
@@ -7,8 +7,9 @@ export interface ExtractFlags {
     templateName: string;
     userEmail: string;
     userPassword: string;
+    disableTelemetry?: boolean;
 }
-export default class ExtractCommand extends Command {
+export default class ExtractCommand extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
@@ -19,6 +20,7 @@ export default class ExtractCommand extends Command {
         templateName: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         userEmail: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         userPassword: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        disableTelemetry: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     /**
      * Main run method for the ExtractCommand

package/dist/commands/extract.js

@@ -1,17 +1,19 @@
-import { text, password, select, intro } from '@clack/prompts';
-import { Command, ux } from '@oclif/core';
+import { text, select, intro, log } from '@clack/prompts';
+import { ux } from '@oclif/core';
 import slugify from '@sindresorhus/slugify';
 import chalk from 'chalk';
 import fs from 'node:fs';
 import path from 'pathe';
 import * as customFlags from '../flags/common.js';
-import { DIRECTUS_PINK, DIRECTUS_PURPLE, SEPARATOR } from '../lib/constants.js';
+import { DIRECTUS_PINK, DIRECTUS_PURPLE, SEPARATOR, BSL_LICENSE_TEXT, BSL_LICENSE_CTA, BSL_LICENSE_HEADLINE } from '../lib/constants.js';
 import { animatedBunny } from '../lib/utils/animated-bunny.js';
+import { BaseCommand } from './base.js';
+import { track, shutdown } from '../services/posthog.js';
 import extract from '../lib/extract/index.js';
-import { getDirectusToken, getDirectusUrl, initializeDirectusApi, validateAuthFlags } from '../lib/utils/auth.js';
+import { getDirectusToken, getDirectusUrl, initializeDirectusApi, validateAuthFlags, getDirectusEmailAndPassword } from '../lib/utils/auth.js';
 import catchError from '../lib/utils/catch-error.js';
 import { generatePackageJsonContent, generateReadmeContent, } from '../lib/utils/template-defaults.js';
-export default class ExtractCommand extends Command {
+export default class ExtractCommand extends BaseCommand {
     static description = 'Extract a template from a Directus instance.';
     static examples = [
         '$ directus-template-cli extract',
@@ -25,6 +27,7 @@ export default class ExtractCommand extends Command {
         templateName: customFlags.templateName,
         userEmail: customFlags.userEmail,
         userPassword: customFlags.userPassword,
+        disableTelemetry: customFlags.disableTelemetry,
     };
     /**
      * Main run method for the ExtractCommand
@@ -43,6 +46,22 @@ export default class ExtractCommand extends Command {
      * @returns {Promise<void>} - Returns nothing
      */
     async extractTemplate(templateName, directory, flags) {
+        // Track start of extraction attempt
+        if (!flags.disableTelemetry) {
+            await track({
+                command: 'extract',
+                lifecycle: 'start',
+                distinctId: this.userConfig.distinctId,
+                flags: {
+                    templateName,
+                    templateLocation: directory,
+                    directusUrl: flags.directusUrl,
+                    programmatic: flags.programmatic,
+                },
+                runId: this.runId,
+                config: this.config,
+            });
+        }
         try {
             if (!fs.existsSync(directory)) {
                 fs.mkdirSync(directory, { recursive: true });
@@ -65,6 +84,26 @@ export default class ExtractCommand extends Command {
         ux.action.start(`Extracting template - ${ux.colorize(DIRECTUS_PINK, templateName)} from ${ux.colorize(DIRECTUS_PINK, flags.directusUrl)} to ${ux.colorize(DIRECTUS_PINK, directory)}`);
         await extract(directory);
         ux.action.stop();
+        // Track completion before final messages/exit
+        if (!flags.disableTelemetry) {
+            await track({
+                command: 'extract',
+                lifecycle: 'complete',
+                distinctId: this.userConfig.distinctId,
+                flags: {
+                    templateName,
+                    templateLocation: directory,
+                    directusUrl: flags.directusUrl,
+                    programmatic: flags.programmatic,
+                },
+                runId: this.runId,
+                config: this.config,
+            });
+            await shutdown();
+        }
+        log.warn(BSL_LICENSE_HEADLINE);
+        log.info(BSL_LICENSE_TEXT);
+        log.info(BSL_LICENSE_CTA);
         ux.stdout(SEPARATOR);
         ux.stdout('Template extracted successfully.');
         this.exit(0);
@@ -104,13 +143,8 @@ export default class ExtractCommand extends Command {
             flags.directusToken = directusToken;
         }
         else {
-            const email = await text({
-                message: 'What is your email?',
-            });
-            flags.userEmail = email;
-            const userPassword = await password({
-                message: 'What is our password?',
-            });
+            const { userEmail, userPassword } = await getDirectusEmailAndPassword();
+            flags.userEmail = userEmail;
             flags.userPassword = userPassword;
         }
         ux.stdout(SEPARATOR);

package/dist/commands/init.d.ts

@@ -3,7 +3,7 @@ export interface InitFlags {
     frontend?: string;
     gitInit?: boolean;
     installDeps?: boolean;
-    overrideDir?: boolean;
+    overwriteDir?: boolean;
     template?: string;
     disableTelemetry?: boolean;
 }
@@ -22,7 +22,7 @@ export default class InitCommand extends BaseCommand {
         frontend: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         gitInit: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         installDeps: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        overrideDir: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        overwriteDir: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         template: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         disableTelemetry: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/init.js

@@ -1,4 +1,4 @@
-import { confirm, intro, select, text, isCancel, cancel } from '@clack/prompts';
+import { confirm, intro, select, text, isCancel, cancel, log as clackLog } from '@clack/prompts';
 import { Args, Flags, ux } from '@oclif/core';
 import chalk from 'chalk';
 import fs from 'node:fs';
@@ -45,7 +45,9 @@ export default class InitCommand extends BaseCommand {
             default: true,
             description: 'Install dependencies automatically',
         }),
-        overrideDir: Flags.boolean({
+        overwriteDir: Flags.boolean({
+            aliases: ['overwrite-dir'],
+            allowNo: true,
             default: false,
             description: 'Override the default directory',
         }),
@@ -81,7 +83,7 @@ export default class InitCommand extends BaseCommand {
         const github = createGitHub();
         // If no dir is provided, ask for it
         if (!args.directory || args.directory === '.') {
-            const dirResponse = await text({
+            let dirResponse = await text({
                 message: 'Enter the directory to create the project in:',
                 placeholder: './my-directus-project',
             });
@@ -89,30 +91,38 @@ export default class InitCommand extends BaseCommand {
                 cancel('Project creation cancelled.');
                 process.exit(0);
             }
+            // If there's no response, set a default
+            if (!dirResponse) {
+                clackLog.warn('No directory provided, using default: ./my-directus-project');
+                dirResponse = './my-directus-project';
+            }
             this.targetDir = dirResponse;
         }
-        if (fs.existsSync(this.targetDir) && !flags.overrideDir) {
-            const overrideDirResponse = await confirm({
+        if (fs.existsSync(this.targetDir) && !flags.overwriteDir) {
+            const overwriteDirResponse = await confirm({
                 message: 'Directory already exists. Would you like to overwrite it?',
+                initialValue: false,
             });
-            if (isCancel(overrideDirResponse)) {
+            if (isCancel(overwriteDirResponse) || overwriteDirResponse === false) {
                 cancel('Project creation cancelled.');
                 process.exit(0);
             }
-            if (overrideDirResponse) {
-                flags.overrideDir = true;
+            if (overwriteDirResponse) {
+                flags.overwriteDir = true;
             }
         }
-        // 1. Fetch available templates
+        // 1. Fetch available templates (now returns Array<{id: string, name: string, description?: string}>)
         const availableTemplates = await github.getTemplates();
         // 2. Prompt for template if not provided
-        let { template } = flags;
+        let { template } = flags; // This will store the chosen template ID
+        let chosenTemplateObject;
         if (!template) {
             const templateResponse = await select({
                 message: 'Which Directus backend template would you like to use?',
-                options: availableTemplates.map(template => ({
-                    label: template,
-                    value: template,
+                options: availableTemplates.map(tmpl => ({
+                    value: tmpl.id, // The value submitted will be the ID (directory name)
+                    label: tmpl.name, // Display the friendly name
+                    hint: tmpl.description, // Show the description as a hint
                 })),
             });
             if (isCancel(templateResponse)) {
@@ -121,22 +131,25 @@ export default class InitCommand extends BaseCommand {
             }
             template = templateResponse;
         }
-        // 3. Validate that the template exists, fetch subdirectories
-        let directories = await github.getTemplateDirectories(template);
+        // Find the chosen template object for potential future use (e.g., display name later)
+        chosenTemplateObject = availableTemplates.find(t => t.id === template);
+        // 3. Validate that the template exists in the available list
         const isDirectUrl = template?.startsWith('http');
-        while (!isDirectUrl && directories.length === 0) {
-            this.log(`Template "${template}" doesn't seem to exist in directus-labs/directus-starters.`);
+        // Validate against the 'id' property of the template objects
+        while (!isDirectUrl && !availableTemplates.some(t => t.id === template)) {
+            // Keep the warning message simple or refer back to the list shown in the prompt
+            clackLog.warn(`Template ID "${template}" is not valid. Please choose from the list provided or enter a direct GitHub URL.`);
             const templateNameResponse = await text({
-                message: 'Please enter a valid template name, or Ctrl+C to cancel:',
+                message: 'Please enter a valid template ID, a direct GitHub URL, or Ctrl+C to cancel:',
             });
             if (isCancel(templateNameResponse)) {
                 cancel('Project creation cancelled.');
                 process.exit(0);
             }
             template = templateNameResponse;
-            directories = await github.getTemplateDirectories(template);
+            chosenTemplateObject = availableTemplates.find(t => t.id === template); // Update chosen object after re-entry
         }
-        flags.template = template;
+        flags.template = template; // Ensure the flag stores the ID
         // Download the template to a temporary directory to read its configuration
         const tempDir = path.join(os.tmpdir(), `directus-template-${Date.now()}`);
         let chosenFrontend = flags.frontend;
@@ -215,7 +228,7 @@ export default class InitCommand extends BaseCommand {
                 gitInit: initGit,
                 installDeps,
                 template,
-                overrideDir: flags.overrideDir,
+                overwriteDir: flags.overwriteDir,
             },
         });
         // Track the command completion unless telemetry is disabled
@@ -229,7 +242,7 @@ export default class InitCommand extends BaseCommand {
                     gitInit: initGit,
                     installDeps,
                     template,
-                    overrideDir: flags.overrideDir,
+                    overwriteDir: flags.overwriteDir,
                 },
                 runId: this.runId,
                 config: this.config,

package/dist/lib/constants.d.ts

@@ -1,6 +1,8 @@
 export declare const DIRECTUS_PURPLE = "#6644ff";
 export declare const DIRECTUS_PINK = "#FF99DD";
 export declare const SEPARATOR = "------------------";
+export declare const pinkText: import("chalk").ChalkInstance;
+export declare const purpleText: import("chalk").ChalkInstance;
 export declare const COMMUNITY_TEMPLATE_REPO: {
     string: string;
     url: string;
@@ -15,3 +17,9 @@ export declare const DEFAULT_REPO: {
 export declare const POSTHOG_PUBLIC_KEY = "phc_STopE6gj6LDIjYonVF7493kQJK8S4v0Xrl6YPr2z9br";
 export declare const POSTHOG_HOST = "https://us.i.posthog.com";
 export declare const DEFAULT_BRANCH = "main";
+export declare const BSL_LICENSE_URL = "https://directus.io/bsl";
+export declare const BSL_EMAIL = "licensing@directus.io";
+export declare const BSL_LICENSE_HEADLINE = "You REQUIRE a license to use Directus if your organization has more than $5MM USD a year in revenue and/or funding.";
+export declare const BSL_LICENSE_TEXT = "For all organizations with less than $5MM USD a year in revenue and funding, Directus is free for personal projects, hobby projects and in production. This second group does not require a license. Directus is licensed under BSL 1.1.";
+export declare const BSL_LICENSE_CTA: string;
+export declare const DEFAULT_DIRECTUS_URL = "http://localhost:8055";