create-nextblock 0.2.25 → 0.2.26

package/bin/create-nextblock.js

@@ -177,15 +177,19 @@ async function runSetupWizard(projectDir, projectName) {
   const projectPath = resolve(projectDir);
   process.chdir(projectPath);
 
-  clack.intro('🚀 Welcome to the NextBlock setup wizard!');
-
-  const supabaseDir = resolve(projectPath, 'supabase');
-  await fs.ensureDir(supabaseDir);
-  await resetSupabaseProjectRef(projectPath);
-
-  clack.note('Connecting to Supabase...');
-  clack.note('I will now open your browser to log into Supabase.');
-  await runSupabaseCli(['login'], { cwd: projectPath });
+  clack.intro('🚀 Welcome to the NextBlock setup wizard!');
+
+  const supabaseDir = resolve(projectPath, 'supabase');
+  await fs.ensureDir(supabaseDir);
+  await resetSupabaseProjectRef(projectPath);
+
+  clack.note(
+    'Supabase Prerequisites:\n\nBefore proceeding, ensure you have a Supabase project ready.\n\nSupabase Cloud: Create a project at https://supabase.com/dashboard\n\nVercel Storage: If created via Vercel > Storage > Create Database, check your .env.local snippet on Vercel for the required keys.',
+  );
+
+  clack.note('Connecting to Supabase...');
+  clack.note('I will now open your browser to log into Supabase.');
+  await runSupabaseCli(['login'], { cwd: projectPath });
 
   clack.note('Now, please select your NextBlock project when prompted.');
   await runSupabaseCli(['link'], { cwd: projectPath });
@@ -226,24 +230,27 @@ async function runSetupWizard(projectDir, projectName) {
   const siteUrl = siteUrlPrompt.trim();
 
   clack.note('Please go to your Supabase project dashboard to get the following secrets.');
-  const supabaseKeys = await clack.group(
-    {
-      dbPassword: () =>
-        clack.password({
-          message: 'What is your Database Password? (Settings > Database > Connection Parameters)',
-          validate: (val) => (!val ? 'Password is required' : undefined),
-        }),
-      anonKey: () =>
-        clack.password({
-          message: 'What is your Project API Key (anon key)? (Settings > API > Project API Keys)',
-          validate: (val) => (!val ? 'Anon Key is required' : undefined),
-        }),
-      serviceKey: () =>
-        clack.password({
-          message: 'What is your Service Role Key (service_role key)? (Settings > API > Project API Keys)',
-          validate: (val) => (!val ? 'Service Role Key is required' : undefined),
-        }),
-    },
+  const supabaseKeys = await clack.group(
+    {
+      dbPassword: () =>
+        clack.password({
+          message:
+            'What is your Database Password? (Supabase: Database > Database Settings > Reset database password | Vercel: POSTGRES_PASSWORD)',
+          validate: (val) => (!val ? 'Password is required' : undefined),
+        }),
+      anonKey: () =>
+        clack.password({
+          message:
+            'What is your Project API Key (anon key)? (Supabase: Project Settings > API Keys > Project Legacy API Keys | Vercel: SUPABASE_ANON_KEY)',
+          validate: (val) => (!val ? 'Anon Key is required' : undefined),
+        }),
+      serviceKey: () =>
+        clack.password({
+          message:
+            'What is your Service Role Key (service_role key)? (Supabase: Project Settings > API Keys > Project Legacy API Keys | Vercel: SUPABASE_SERVICE_ROLE_KEY)',
+          validate: (val) => (!val ? 'Service Role Key is required' : undefined),
+        }),
+    },
     { onCancel: () => handleWizardCancel('Setup cancelled.') },
   );
 
@@ -331,12 +338,15 @@ async function runSetupWizard(projectDir, projectName) {
     }
   }
 
-  const setupR2 = await clack.confirm({
-    message: 'Do you want to set up Cloudflare R2 for media storage now? (Optional)',
-  });
-  if (clack.isCancel(setupR2)) {
-    handleWizardCancel('Setup cancelled.');
-  }
+  clack.note(
+    'Optional Cloudflare R2 Setup:\nHave your Account ID, API token (Access + Secret), bucket name, and public bucket URL handy if you want media storage ready now.',
+  );
+  const setupR2 = await clack.confirm({
+    message: 'Do you want to set up Cloudflare R2 for media storage now? (Optional > populate .env keys)',
+  });
+  if (clack.isCancel(setupR2)) {
+    handleWizardCancel('Setup cancelled.');
+  }
 
   let r2Values = {
     publicBaseUrl: '',
@@ -350,33 +360,34 @@ async function runSetupWizard(projectDir, projectName) {
     clack.note('I will open your browser to the R2 dashboard.\nYou need to create a bucket and an R2 API Token.');
     await open('https://dash.cloudflare.com/?to=/:account/r2', { wait: false });
 
-    const r2Keys = await clack.group(
-      {
-        accountId: () =>
-          clack.text({
-            message: 'R2: Paste your Cloudflare Account ID:',
-            validate: (val) => (!val ? 'Account ID is required' : undefined),
-          }),
-        bucketName: () =>
+    const r2Keys = await clack.group(
+      {
+        accountId: () =>
+          clack.text({
+            message: 'R2: Paste your Cloudflare Account ID (Overview > Account Details - Bottom right):',
+            validate: (val) => (!val ? 'Account ID is required' : undefined),
+          }),
+        bucketName: () =>
           clack.text({
             message: 'R2: Paste your Bucket Name:',
             validate: (val) => (!val ? 'Bucket name is required' : undefined),
           }),
-        accessKey: () =>
-          clack.password({
-            message: 'R2: Paste your Access Key ID:',
-            validate: (val) => (!val ? 'Access Key ID is required' : undefined),
-          }),
+        accessKey: () =>
+          clack.password({
+            message: 'R2: Paste your Access Key ID (create API tokens):',
+            validate: (val) => (!val ? 'Access Key ID is required' : undefined),
+          }),
         secretKey: () =>
           clack.password({
             message: 'R2: Paste your Secret Access Key:',
             validate: (val) => (!val ? 'Secret Access Key is required' : undefined),
           }),
-        publicBaseUrl: () =>
-          clack.text({
-            message: 'R2: Public Base URL (e.g., https://pub-xxx.r2.dev/your-bucket):',
-            validate: (val) => (!val ? 'Public base URL is required' : undefined),
-          }),
+        publicBaseUrl: () =>
+          clack.text({
+            message:
+              'R2: Public Base URL (Bucket > Settings > Public Development URL-Enable: e.g., https://pub-xxx.r2.dev)',
+            validate: (val) => (!val ? 'Public base URL is required' : undefined),
+          }),
       },
       { onCancel: () => handleWizardCancel('Setup cancelled.') },
     );
@@ -406,7 +417,10 @@ async function runSetupWizard(projectDir, projectName) {
     clack.note('Cloudflare R2 placeholders added to .env. Configure them later when ready.');
   }
 
-  const setupSMTP = await clack.confirm({
+  clack.note(
+    'Optional SMTP Setup:\nProvide the host, port, credentials, and from details for your email provider (e.g., Resend, Postmark) to send transactional emails immediately.',
+  );
+  const setupSMTP = await clack.confirm({
     message: 'Do you want to set up an SMTP server for emails now? (Optional)',
   });
   if (clack.isCancel(setupSMTP)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nextblock",
-  "version": "0.2.25",
+  "version": "0.2.26",
   "description": "",
   "main": "index.js",
   "bin": {