LoperBoys/legacy-site/SETUP-GUIDE.md

LoperBoys Website - Setup Guide

Project Overview

Name: LoperBoys
Domain: loperboys.com
Purpose: Lawn care, home maintenance, and seasonal services website
Owner: John Loper
Created: April 13, 2026

---

Repository Information

Gitea Repository: https://gitea.loperfamily.com/Sage_Software/LoperBoys

---

Files Created

All website files are located in the LoperBoys.com/ subfolder:

File	Size	Description
LoperBoys.com/index.html	20,530 bytes	Main HTML page with all content
LoperBoys.com/styles.css	12,333 bytes	CSS styles and responsive design
LoperBoys.com/script.js	6,657 bytes	JavaScript for form handling and interactivity
README.md	2,584 bytes	Project documentation
PROJECT_STATUS.md	3,075 bytes	Project tracking and status

---

How to Access the Website

Option 1: Open in Browser (Quick Test)

1. Navigate to: /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com/
2. Open index.html in your web browser
3. You can now view the full website locally

Option 2: Set Up Local Web Server

Using Python (quick test):

cd /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com
python3 -m http.server 8080

Then open http://localhost:8080 in your browser.

Using Node.js (if you have it):

cd /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com
npx serve

Option 3: Deploy to Your Server

For nginx (recommended):

1. Copy files to your web server:

   sudo cp -r /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com/* /var/www/html/
   

2. Configure nginx (add to /etc/nginx/sites-available/loperboys):

   server {
       listen 80;
       server_name loperboys.com www.loperboys.com;
   
       root /var/www/html;
       index index.html;
   
       location / {
           try_files $uri $uri/ =404;
       }
   }
   

3. Enable the site:

   sudo ln -s /etc/nginx/sites-available/loperboys /etc/nginx/sites-enabled/
   sudo nginx -t
   sudo systemctl reload nginx
   

For Apache:

1. Create virtual host file at /etc/apache2/sites-available/loperboys.conf:

   <VirtualHost *:80>
       ServerName loperboys.com
       ServerAlias www.loperboys.com
       DocumentRoot /var/www/html
   
       DirectoryIndex index.html
   </VirtualHost>
   

2. Enable the site:

   sudo a2ensite loperboys.conf
   sudo systemctl reload apache2
   

---

Email Configuration

The contact form needs email backend setup:

Current Setup

• SMTP Server: 10.10.9.31
• SMTP Port: 25
• Inbound Email: contact@loperboys.com

To Enable Email Backend

You'll need a simple Node.js or Python script to handle incoming mail. Here's a basic Node.js example:

// email-handler.js
const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
    host: '10.10.9.31',
    port: 25,
});

transporter.sendMail({
    from: 'contact@loperboys.com',
    to: 'john@loperfamily.com',  // Your email
    subject: 'LoperBoys Inquiry',
    text: 'New inquiry from website',
    html: '<p>New inquiry from website</p>'
}, (error, info) => {
    if (error) {
        console.log(error);
    } else {
        console.log('Message sent: ' + info.response);
    }
});

---

Payment Processing

The site currently displays these payment methods:

• 💵 Cash
• 📱 Venmo
• 📲 Cash App
• 💳 PayPal
• 💳 Stripe

John mentioned having existing code for PayPal and Stripe. These can be integrated when needed.

---

DNS Configuration

For loperboys.com Domain

1. Log into your domain registrar (where you bought loperboys.com)

2. Add/update the following DNS records:

   Type: A
   Name: @
   Value: [Your server's public IP address]
   
   Type: CNAME
   Name: www
   Value: loperboys.com
   

3. Wait for DNS propagation (can take 24-48 hours)

---

Testing Checklist

Before going live, test the following:

• Website loads correctly in multiple browsers (Chrome, Firefox, Safari)
• Mobile responsive design works on phone and tablet
• Contact form submits successfully
• All links work (navigation, service links, footer links)
• Images display correctly
• Pricing is accurate
• Contact information is correct
• Phone number clicks to dial on mobile

---

Current Status

Item	Status	Notes
Website files	✅ Created	All files in LoperBoys.com/ folder
Git repository	✅ Created	https://gitea.loperfamily.com/Sage_Software/LoperBoys
Local git	✅ Initialized	Ready for commits
Push to Gitea	⚠️ Pending	Authentication issue - see below
Email backend	⏳ Needs setup	Configure SMTP server
Payment integration	⏳ Needs setup	Add PayPal/Stripe code
DNS configuration	⏳ Needs setup	Point domain to server
Server deployment	⏳ Needs setup	Configure web server

---

Troubleshooting

Git Push Issues

If you have issues pushing to Gitea:

1. Check credentials are correct in ~/.git-credentials
2. Or use the web interface to upload files manually
3. Or contact John to handle the push

Website Not Loading

1. Make sure you're opening from the correct path: /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com/index.html
2. Check browser console for errors
3. Verify all CSS and JS files are loaded

Form Not Submitting

The contact form currently uses a mailto fallback. For full email functionality, you need to set up the SMTP backend as described above.

---

Next Steps

1. Test locally - Open the website in your browser to verify everything works
2. Set up web server - Configure nginx or Apache
3. Configure email - Set up the SMTP handler for contact form
4. Deploy - Copy files to production server
5. Configure DNS - Point domain to server
6. Test live - Verify everything works on the live server

---

Contact

Phone: 220-200-4022
Email: contact@loperboys.com
Service Area: Warsaw, Coshocton, and surrounding areas

---

Setup guide created: April 13, 2026