Quick Start Guide

Get your LaHave website up and running quickly.

1. Install Ruby and Jekyll

Windows:

• Download from RubyInstaller
• Run the installer
• Check “Add Ruby executables to your PATH”

macOS:

brew install ruby

Linux:

sudo apt-get install ruby-full  # Ubuntu/Debian
# or
sudo yum install ruby          # CentOS/RHEL

Then install Jekyll:

gem install jekyll bundler

2. Install Project Dependencies

bundle install

3. Run Local Server

bundle exec jekyll serve

Visit: http://localhost:4000

4. Create GitHub Repository

1. Go to GitHub and create new repository
2. Name it lahave-website
3. Make it Public
4. Don’t initialize with README

5. Push to GitHub

git add .
git commit -m "Initial Jekyll site"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/lahave-website.git
git push -u origin main

6. Enable GitHub Pages

1. Repository → Settings → Pages
2. Source: Deploy from branch
3. Branch: main / / (root)
4. Save

Your site will be at: https://YOUR_USERNAME.github.io/lahave-website/

7. Set Up Formspree

1. Go to formspree.io and sign up
2. Create new form
3. Copy the form ID (the part after /f/)
4. Edit _config.yml:

   formspree_endpoint: "your-form-id-here"
   

5. Commit and push:

   git add _config.yml
   git commit -m "Configure Formspree"
   git push
   

8. Migrate Content

1. Visit your Squarespace site: lahave.io
2. Copy content to corresponding files:
   • Homepage → index.html
   • About → about.md
   • Contact → contact.html (form is already set up)
3. Update styling in assets/css/main.scss to match
4. Add images to assets/images/

See CONTENT_MIGRATION.md for detailed guide.

9. Test Everything

Use TESTING_CHECKLIST.md to verify:

• All pages work
• Contact form works
• Mobile responsive
• No broken links

10. Deploy Updates

After making changes:

git add .
git commit -m "Update content"
git push

GitHub Pages rebuilds automatically.

11. Migrate DNS (When Ready)

Only do this when site is fully tested and ready!

See DNS_MIGRATION.md for complete instructions.

Quick version:

1. Update DNS records (4 A records + 1 CNAME)
2. Wait 24-48 hours for propagation
3. Verify site works on custom domain

Need Help?

• Setup issues: See SETUP.md
• Content migration: See CONTENT_MIGRATION.md
• Deployment: See DEPLOYMENT.md
• DNS migration: See DNS_MIGRATION.md
• Testing: See TESTING_CHECKLIST.md

Common Commands

# Start local server
bundle exec jekyll serve

# Build site (without server)
bundle exec jekyll build

# Check for issues
bundle exec jekyll doctor

# Update dependencies
bundle update

Next Steps

1. ✅ Install Ruby and Jekyll
2. ✅ Set up local development
3. ✅ Create GitHub repository
4. ✅ Deploy to GitHub Pages
5. ✅ Configure Formspree
6. ⏳ Migrate content from Squarespace
7. ⏳ Test thoroughly
8. ⏳ Migrate DNS when ready