docs: add SECRETS.md for LOVABLE_WEBHOOK_URL, simplify step 5

Made-with: Cursor

Author: asperpharma

.github/SECRETS.md

@@ -0,0 +1,24 @@
+# Repository secrets (GitHub Actions)
+
+Required **Actions** secrets so CI workflows run as intended.
+
+## LOVABLE_WEBHOOK_URL (required for “Notify Lovable”)
+
+The **Build and Push to Lovable** workflow (`build-and-push-to-lovable.yml`) runs a **Notify Lovable** step after each push to `main`. That step only runs when this secret is set; otherwise the deploy job is skipped.
+
+**How to set it**
+
+1. Open the repo on GitHub: **Settings → Secrets and variables → Actions**.
+2. Click **New repository secret**.
+3. Name: `LOVABLE_WEBHOOK_URL`.
+4. Value: the webhook URL from Lovable (file sync / deploy). Get it from your [Lovable project settings](https://lovable.dev/projects/657fb572-13a5-4a3e-bac9-184d39fdf7e6/settings) (or the Integrations / Webhooks section Lovable provides).
+5. Add the secret and save.
+
+After this is set, the “Notify Lovable (push file changes for deploy)” step will run on each push to `main`.
+
+---
+
+Other workflows that use the same secret (and also skip when it’s empty):
+
+- `sync-file-changes-to-lovable.yml`
+- `sync-issues-prs-to-lovable.yml`

.github/workflows/build-and-push-to-lovable.yml

@@ -0,0 +1,91 @@
+# Build and Push to Lovable (Asper Beauty Shop)
+# Repo: asperpharma/understand-project
+# Live: https://asperbeautyshop-com.lovable.app
+#
+# On push to main (or manual run): build + test, then notify Lovable via webhook.
+# The "Notify Lovable" deploy job runs only when LOVABLE_WEBHOOK_URL is set.
+# Setup: see .github/SECRETS.md — add LOVABLE_WEBHOOK_URL in repo Actions secrets.
+
+name: Build and Push to Lovable
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  AZURE_WEBAPP_PACKAGE_PATH: "."
+  NODE_VERSION: "20.x"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: "npm"
+
+      - name: npm install, build, and test
+        run: |
+          npm ci
+          npm run build --if-present
+          npm run test --if-present
+
+      - name: Upload artifact for deployment job
+        uses: actions/upload-artifact@v4
+        with:
+          name: node-app
+          path: .
+
+  deploy:
+    permissions:
+      contents: none
+    runs-on: ubuntu-latest
+    needs: build
+    if: secrets.LOVABLE_WEBHOOK_URL != ''
+    environment:
+      name: Development
+      url: https://asperbeautyshop-com.lovable.app
+    steps:
+      - name: Download artifact from build job
+        uses: actions/download-artifact@v4
+        with:
+          name: node-app
+
+      - name: Notify Lovable (push file changes for deploy)
+        continue-on-error: true
+        env:
+          LOVABLE_WEBHOOK_URL: ${{ secrets.LOVABLE_WEBHOOK_URL }}
+        run: |
+          if [ "${{ github.event_name }}" = "push" ] && [ -f "$GITHUB_EVENT_PATH" ]; then
+            ADDED=$(jq -r '.commits[].added[]?' "$GITHUB_EVENT_PATH" | sort | uniq | jq -R . | jq -s .)
+            MODIFIED=$(jq -r '.commits[].modified[]?' "$GITHUB_EVENT_PATH" | sort | uniq | jq -R . | jq -s .)
+            REMOVED=$(jq -r '.commits[].removed[]?' "$GITHUB_EVENT_PATH" | sort | uniq | jq -R . | jq -s .)
+          else
+            ADDED="[]"
+            MODIFIED="[]"
+            REMOVED="[]"
+          fi
+          COMPARE_URL="${{ github.event.compare }}"
+          [ -z "$COMPARE_URL" ] && COMPARE_URL="https://github.com/${{ github.repository }}/commit/${{ github.sha }}"
+          PAYLOAD=$(jq -n \
+            --arg repo "${{ github.repository }}" \
+            --arg commit "${{ github.sha }}" \
+            --arg sender "${{ github.actor }}" \
+            --arg url "$COMPARE_URL" \
+            --argjson added "$ADDED" \
+            --argjson modified "$MODIFIED" \
+            --argjson removed "$REMOVED" \
+            '{repo: $repo, commit: $commit, sender: $sender, compare_url: $url, added: $added, modified: $modified, removed: $removed}')
+          echo "Sending to Lovable..."
+          curl -s -f -X POST "$LOVABLE_WEBHOOK_URL" \
+            -H "Content-Type: application/json" \
+            -d "$PAYLOAD" || echo "Webhook call failed (non-fatal)."