# 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):
```bash
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):
```bash
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:
   ```bash
   sudo cp -r /home/johnny/.openclaw/workspace/Projects/LoperBoys/LoperBoys.com/* /var/www/html/
   ```

2. Configure nginx (add to `/etc/nginx/sites-available/loperboys`):
   ```nginx
   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:
   ```bash
   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`:
   ```apache
   <VirtualHost *:80>
       ServerName loperboys.com
       ServerAlias www.loperboys.com
       DocumentRoot /var/www/html
       
       DirectoryIndex index.html
   </VirtualHost>
   ```

2. Enable the site:
   ```bash
   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:

```javascript
// 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*