🛠️ Local Dev & Deployment Guide for Sundaysupper.online

🛠️ Local Dev & Deployment Guide for Sundaysupper.online

A quick reference for working on this Jekyll site locally and pushing updates to production.


đź§Ş Local Development

  1. Set Ruby version (use rbenv):
    rbenv shell 3.2.2
    
  2. Install dependencies (only needed if Gemfile changes):
    bundle install
    
  3. Serve the site locally:
    bundle exec jekyll serve
    
  4. Preview in browser:
    http://localhost:4000

🚀 Deploy to GitHub Pages

After confirming the site looks correct locally:

git add .
git commit -m "Update site content/layout/etc"
git push origin main

Your site will auto-deploy to https://sundaysupper.online in ~1–2 minutes.


đź§ą Optional Cleanup

To clear old builds and rebuild from scratch:

bundle exec jekyll clean
bundle exec jekyll serve

đź§° Troubleshooting

  • Make sure you’re using Ruby 3.2.2:
    ruby -v
    
  • Make sure Bundler is ~2.4:
    bundler -v
    
  • If Jekyll fails to load or assets are missing, double-check _config.yml:
    url: "https://sundaysupper.online"
    baseurl: ""