My Site Broke After a Push — Solana Beach

Hey — this almost always comes down to one thing: the deploy succeeded, but a file didn't make it into _site/. Your repo is fine. The live server just got a build that's missing something.

Here's what I'd check first

Go to GitHub → Actions tab. Click the last run. Find the step with the red X and read the actual error. 90% of push-breaks have an obvious message right there — you just have to look.

If the deploy went green but the site is still broken:

git diff HEAD~1 HEAD

That shows exactly what changed. Look for a deleted file, a changed path in the build script, or a config file that excluded something it shouldn't have.

Get back up in 3 minutes

This is almost always caused by a build script change that dropped a key file. Fastest recovery — don't debug with the site down:

git revert HEAD --no-edit
git push

Site's back to the last working state while you figure out the root cause.

Most common culprits

• Build script change removed index.html or CNAME from _site/
• A directory (assets/, css/) dropped out of the copy loop
• YAML formatting error in the deploy workflow
• File renamed in repo but old reference still in HTML