feat: enhance Supabase migration deployment with better error handling and setup instructions

Author: ralyodio

bin/deploy-with-migrations.sh

@@ -46,12 +46,25 @@ fi
 # Run Supabase setup and migrations on the remote server
 echo -e "${YELLOW}Running Supabase setup and migrations on remote server...${NC}"
 
-# Run the Supabase setup
-echo -e "${YELLOW}Running Supabase setup on remote server...${NC}"
+# Run the Supabase setup to ensure proper database association
+echo -e "${YELLOW}Running Supabase setup to link with correct database...${NC}"
 ssh $SSH_OPTS $REMOTE_USER@$REMOTE_HOST "cd $REMOTE_DIR && chmod +x ./bin/supabase-db.sh && ./bin/supabase-db.sh setup"
 
 if [ $? -ne 0 ]; then
   echo -e "${RED}Supabase setup failed. Aborting deployment.${NC}"
+  echo -e "${YELLOW}This usually means the project could not be linked to the correct database.${NC}"
+  echo -e "${YELLOW}Please check your SUPABASE_ACCESS_TOKEN and SUPABASE_DB_PASSWORD in the .env file.${NC}"
+  exit 1
+fi
+
+# Verify the project is properly linked before running migrations
+echo -e "${YELLOW}Verifying Supabase project is properly linked...${NC}"
+ssh $SSH_OPTS $REMOTE_USER@$REMOTE_HOST "cd $REMOTE_DIR && ./bin/supabase-db.sh setup"
+
+if [ $? -ne 0 ]; then
+  echo -e "${RED}Supabase project linking verification failed. Aborting deployment.${NC}"
+  echo -e "${YELLOW}The local config may differ from the linked project.${NC}"
+  echo -e "${YELLOW}Try updating supabase/config.toml or re-linking the project.${NC}"
   exit 1
 fi
 

bin/generator.js

@@ -568,7 +568,12 @@ function generateServerMigration(args) {
     // Suggest next steps
     console.log('\nNext steps:');
     console.log('1. Edit the migration file to add your SQL commands');
-    console.log('2. Apply the migration using Supabase CLI or your deployment process');
+    console.log('2. For local development:');
+    console.log('   - Link project: supabase link --project-ref <your-project-ref>');
+    console.log('   - Apply migration: supabase db push');
+    console.log('3. For CI/CD deployment:');
+    console.log('   - Ensure SUPABASE_ACCESS_TOKEN and SUPABASE_DB_PASSWORD are set');
+    console.log('   - Use: supabase db push --linked in GitHub Actions');
     console.log('   Note: Supabase only supports forward migrations (no DOWN methods)');
   } catch (error) {
     throw error;
@@ -591,6 +596,11 @@ Usage:
 Options:
   --name           Migration name (required, e.g., "add_user_fields" or "AddUserFields")
   --help           Show this help information
+
+Important Setup Notes:
+  - For local development: Ensure project is linked with 'supabase link --project-ref <ref>'
+  - For CI/CD deployments: Set SUPABASE_ACCESS_TOKEN and SUPABASE_DB_PASSWORD in secrets
+  - If you see "Local config differs from linked project", update supabase/config.toml
   `);
 }