Enable anonymous development (#36215)

The main change is having `shouldAllowAnonymousDevelopment` default to returning true! `CONVEX_ALLOW_ANONYMOUS=false` will function as an opt out (as will `npx convex dev --configure` since it'll ask you if you want to log in and create an account instead).

Also updated some copy to say "project" instead of "deployment".

GitOrigin-RevId: 9addd1796a3e5c18bd8902c9d75622a3dd0dd59a

Author: sshader

npm-packages/convex/src/cli/configure.ts

@@ -261,21 +261,23 @@ export async function _deploymentCredentialsOrConfigure(
           cmdOptions,
         );
       }
-      const shouldPromptForLogin =
-        deploymentSelection.deploymentName !== null
-          ? "no"
-          : await promptOptions(ctx, {
-              message:
-                "Welcome to Convex! Would you like to login to your account?",
-              choices: [
-                {
-                  name: "Start without an account (run Convex locally)",
-                  value: "no",
-                },
-                { name: "Login or create an account", value: "yes" },
-              ],
-              default: "no",
-            });
+      const alreadyHasConfiguredAnonymousDeployment =
+        deploymentSelection.deploymentName !== null &&
+        chosenConfiguration === null;
+      const shouldPromptForLogin = alreadyHasConfiguredAnonymousDeployment
+        ? "no"
+        : await promptOptions(ctx, {
+            message:
+              "Welcome to Convex! Would you like to login to your account?",
+            choices: [
+              {
+                name: "Start without an account (run Convex locally)",
+                value: "no",
+              },
+              { name: "Login or create an account", value: "yes" },
+            ],
+            default: "no",
+          });
       if (shouldPromptForLogin === "no") {
         const result = await handleAnonymousDeployment(ctx, {
           chosenConfiguration,

npm-packages/convex/src/cli/deploy.ts

@@ -109,7 +109,11 @@ Same format as .env.local or .env files, and overrides them.`,
           "To deploy your Convex app to the cloud, log in by running `npx convex login`.\n" +
           "See https://docs.convex.dev/production for more information on how Convex cloud works and instructions on how to set up hosting.",
       );
-      return;
+      return await ctx.crash({
+        exitCode: 1,
+        errorType: "fatal",
+        printedMessage: null,
+      });
     }
 
     if (deploymentSelection.kind === "preview") {

npm-packages/convex/src/cli/lib/deploymentSelection.ts

@@ -620,6 +620,9 @@ export const deploymentNameAndTypeFromSelection = (
 };
 
 export const shouldAllowAnonymousDevelopment = (): boolean => {
-  // Temporary flag while we build out this flow
-  return process.env.CONVEX_ALLOW_ANONYMOUS !== undefined;
+  // Kill switch / temporary opt out
+  if (process.env.CONVEX_ALLOW_ANONYMOUS === "false") {
+    return false;
+  }
+  return true;
 };

npm-packages/convex/src/cli/lib/localDeployment/anonymous.ts

@@ -73,11 +73,11 @@ export async function handleAnonymousDeployment(
   if (deployment.kind === "first") {
     logMessage(
       ctx,
-      "This command, `npx convex dev`, will run your deployment and update it with the function you write in the `convex/` directory.",
+      "This command, `npx convex dev`, will run your Convex backend locally and update it with the function you write in the `convex/` directory.",
     );
     logMessage(
       ctx,
-      "Use `npx convex dashboard` to view and interact with your deployment from a web UI.",
+      "Use `npx convex dashboard` to view and interact with your project from a web UI.",
     );
     logMessage(
       ctx,
@@ -86,7 +86,7 @@ export async function handleAnonymousDeployment(
     ensureUuidForAnonymousUser(ctx);
     if (process.stdin.isTTY) {
       const result = await promptYesNo(ctx, {
-        message: "Got it? Let's get started!",
+        message: "Continue?",
         default: true,
       });
       if (!result) {
@@ -249,7 +249,7 @@ async function chooseDeployment(
     if (existing === undefined) {
       logWarning(
         ctx,
-        `Could not find deployment with name ${options.deploymentName}!`,
+        `Could not find project with name ${options.deploymentName}!`,
       );
     } else {
       return {
@@ -260,13 +260,13 @@ async function chooseDeployment(
     }
   }
   if (deployments.length === 0) {
-    logMessage(ctx, "Let's set up your first deployment.");
+    logMessage(ctx, "Let's set up your first project.");
     return await promptForNewDeployment(ctx, []);
   }
 
   if (options.chosenConfiguration === "new") {
     const deploymentName = await promptString(ctx, {
-      message: "Choose a name for your new deployment:",
+      message: "Choose a name for your new project:",
       default: path.basename(process.cwd()),
     });
     const uniqueName = await getUniqueName(
@@ -282,7 +282,7 @@ async function chooseDeployment(
   }
 
   const newOrExisting = await promptSearch(ctx, {
-    message: "Which deployment would you like to use?",
+    message: "Which project would you like to use?",
     choices: [
       ...(options.chosenConfiguration === "existing"
         ? []
@@ -307,7 +307,7 @@ async function chooseDeployment(
       return ctx.crash({
         exitCode: 1,
         errorType: "fatal",
-        printedMessage: `Could not find deployment with name ${newOrExisting}!`,
+        printedMessage: `Could not find project with name ${newOrExisting}!`,
       });
     }
     return {
@@ -381,7 +381,7 @@ async function getUniqueName(
   return ctx.crash({
     exitCode: 1,
     errorType: "fatal",
-    printedMessage: `Could not generate a unique name for your deployment, please choose a different name`,
+    printedMessage: `Could not generate a unique name for your project, please choose a different name`,
   });
 }
 /**