create-mastra 0.15.0 → 0.15.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # create-mastra
 
+## 0.15.1-alpha.0
+
+### Patch Changes
+
+- Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
+
 ## 0.15.0
 
 ### Patch Changes

package/dist/index.js

@@ -2042,14 +2042,12 @@ var getAPIKey = async (provider) => {
       return key;
   }
 };
-var writeAPIKey = async ({
-  provider,
-  apiKey = "your-api-key"
-}) => {
+var writeAPIKey = async ({ provider, apiKey }) => {
+  const envFileName = apiKey ? ".env" : ".env.example";
   const key = await getAPIKey(provider);
   const escapedKey = shellQuote.quote([key]);
-  const escapedApiKey = shellQuote.quote([apiKey]);
-  await exec2(`echo ${escapedKey}=${escapedApiKey} >> .env`);
+  const escapedApiKey = shellQuote.quote([apiKey ? apiKey : "your-api-key"]);
+  await exec2(`echo ${escapedKey}=${escapedApiKey} >> ${envFileName}`);
 };
 var createMastraDir = async (directory) => {
   let dir = directory.trim().split("/").filter((item) => item !== "");
@@ -2070,8 +2068,19 @@ var writeCodeSample = async (dirPath, component, llmProvider, importComponents)
     throw err;
   }
 };
-var interactivePrompt = async () => {
-  Ie(color2.inverse(" Mastra Init "));
+var LLM_PROVIDERS = [
+  { value: "openai", label: "OpenAI", hint: "recommended" },
+  { value: "anthropic", label: "Anthropic" },
+  { value: "groq", label: "Groq" },
+  { value: "google", label: "Google" },
+  { value: "cerebras", label: "Cerebras" },
+  { value: "mistral", label: "Mistral" }
+];
+var interactivePrompt = async (args2 = {}) => {
+  const { skip = {}, options: { showBanner = true } = {} } = args2;
+  if (showBanner) {
+    Ie(color2.inverse(" Mastra Init "));
+  }
   const mastraProject = await Ce(
     {
       directory: () => he({
@@ -2079,20 +2088,15 @@ var interactivePrompt = async () => {
         placeholder: "src/",
         defaultValue: "src/"
       }),
-      llmProvider: () => ve({
-        message: "Select default provider:",
-        options: [
-          { value: "openai", label: "OpenAI", hint: "recommended" },
-          { value: "anthropic", label: "Anthropic" },
-          { value: "groq", label: "Groq" },
-          { value: "google", label: "Google" },
-          { value: "cerebras", label: "Cerebras" },
-          { value: "mistral", label: "Mistral" }
-        ]
+      llmProvider: () => skip?.llmProvider ? void 0 : ve({
+        message: "Select a default provider:",
+        options: LLM_PROVIDERS
       }),
       llmApiKey: async ({ results: { llmProvider } }) => {
+        if (skip?.llmApiKey) return void 0;
+        const llmName = LLM_PROVIDERS.find((p6) => p6.value === llmProvider)?.label || "provider";
         const keyChoice = await ve({
-          message: `Enter your ${llmProvider} API key?`,
+          message: `Enter your ${llmName} API key?`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
             { value: "enter", label: "Enter API key" }
@@ -2102,7 +2106,10 @@ var interactivePrompt = async () => {
         if (keyChoice === "enter") {
           return he({
             message: "Enter your API key:",
-            placeholder: "sk-..."
+            placeholder: "sk-...",
+            validate: (value) => {
+              if (value.length === 0) return "API key cannot be empty";
+            }
           });
         }
         return void 0;
@@ -2112,7 +2119,7 @@ var interactivePrompt = async () => {
         const cursorIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`cursor`);
         const vscodeIsAlreadyInstalled = await globalMCPIsAlreadyInstalled(`vscode`);
         const editor = await ve({
-          message: `Make your AI IDE into a Mastra expert? (installs Mastra docs MCP server)`,
+          message: `Make your IDE into a Mastra expert? (Installs Mastra's MCP server)`,
           options: [
             { value: "skip", label: "Skip for now", hint: "default" },
             {
@@ -2324,18 +2331,34 @@ async function installMastraDependency(pm, dependency, versionTag, isDev, timeou
 var createMastraProject = async ({
   projectName: name,
   createVersionTag,
-  timeout
+  timeout,
+  llmProvider,
+  llmApiKey,
+  needsInteractive
 }) => {
   Ie(color2.inverse(" Mastra Create "));
   const projectName = name ?? await he({
     message: "What do you want to name your project?",
     placeholder: "my-mastra-app",
-    defaultValue: "my-mastra-app"
+    defaultValue: "my-mastra-app",
+    validate: (value) => {
+      if (value.length === 0) return "Project name cannot be empty";
+      if (fs4__default__default.existsSync(value)) {
+        return `A directory named "${value}" already exists. Please choose a different name.`;
+      }
+    }
   });
   if (pD(projectName)) {
     xe("Operation cancelled");
     process.exit(0);
   }
+  let result;
+  if (needsInteractive) {
+    result = await interactivePrompt({
+      options: { showBanner: false },
+      skip: { llmProvider: llmProvider !== void 0, llmApiKey: llmApiKey !== void 0 }
+    });
+  }
   const s2 = Y();
   try {
     s2.start("Creating project");
@@ -2396,15 +2419,15 @@ var createMastraProject = async ({
       );
     }
     s2.stop(`${pm} dependencies installed`);
-    s2.start("Installing mastra");
+    s2.start("Installing Mastra CLI");
     const versionTag = createVersionTag ? `@${createVersionTag}` : "@latest";
     try {
       await installMastraDependency(pm, "mastra", versionTag, true, timeout);
     } catch (error) {
       throw new Error(`Failed to install Mastra CLI: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    s2.stop("mastra installed");
-    s2.start("Installing dependencies");
+    s2.stop("Mastra CLI installed");
+    s2.start("Installing Mastra dependencies");
     try {
       await installMastraDependency(pm, "@mastra/core", versionTag, false, timeout);
       await installMastraDependency(pm, "@mastra/libsql", versionTag, false, timeout);
@@ -2431,7 +2454,7 @@ var createMastraProject = async ({
     s2.stop(".gitignore added");
     Se("Project created successfully");
     console.info("");
-    return { projectName };
+    return { projectName, result };
   } catch (error) {
     s2.stop();
     const errorMessage = error instanceof Error ? error.message : "An unexpected error occurred";
@@ -2444,14 +2467,17 @@ var create = async (args2) => {
     await createFromTemplate({ ...args2, injectedAnalytics: args2.analytics });
     return;
   }
-  const { projectName } = await createMastraProject({
+  const needsInteractive = args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0;
+  const { projectName, result } = await createMastraProject({
     projectName: args2?.projectName,
     createVersionTag: args2?.createVersionTag,
-    timeout: args2?.timeout
+    timeout: args2?.timeout,
+    llmProvider: args2?.llmProvider,
+    llmApiKey: args2?.llmApiKey,
+    needsInteractive
   });
   const directory = args2.directory || "src/";
-  if (args2.components === void 0 || args2.llmProvider === void 0 || args2.addExample === void 0) {
-    const result = await interactivePrompt();
+  if (needsInteractive && result) {
     await init({
       ...result,
       llmApiKey: result?.llmApiKey,
@@ -2701,7 +2727,7 @@ program.name("create-mastra").description("Create a new Mastra project").argumen
     components: args.components ? args.components.split(",") : [],
     llmProvider: args.llm,
     addExample: args.example,
-    llmApiKey: args["llm-api-key"],
+    llmApiKey: args.llmApiKey,
     createVersionTag,
     timeout,
     projectName,