CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

BovPro landing page — a Jekyll static site for the BovPro cattle herd management mobile app. All content is in Brazilian Portuguese (PT-BR). Hosted at bovpro.com.br via HostGator FTP, deployed automatically through GitHub Actions on push to main.

Development Commands

# Install dependencies
./run-install.sh          # or: bundle install

# Development server with live reload (http://localhost:4000)
./run-dev.sh

# Production build (output to _site/)
./run-build.sh

./run-dev.sh uses both _config.yml and _config_dev.yml (dev overrides: no baseurl, livereload enabled, incremental builds, drafts enabled).

Architecture

Framework: Jekyll with the Minimal Mistakes theme (minimal-mistakes-jekyll)
Dependencies: Managed via Bundler; github-pages ~> 232 gem ensures GitHub Pages compatibility
Ruby version: 3.1 (required by github-pages)
Hosting: HostGator with FTP deployment via GitHub Actions
Domain: bovpro.com.br
URL: https://bovpro.com.br

Content Structure

Pages are Markdown files with YAML frontmatter:

index.md — Landing page (splash layout with hero, feature rows, CTAs)
about.md — About page describing BovPro and Mutum Soft
bovpro/politica-de-privacidade.md — Privacy policy
404.html — Custom 404 page in Portuguese

Customization Points

_config.yml — Site-wide settings (title, URL, theme, plugins)
- title: BovPro
- email: bovpro@mutumsoft.com
- url: https://bovpro.com.br
- baseurl: /
- theme: minimal-mistakes-jekyll
- encoding: utf-8
_config_dev.yml — Development overrides (merged via --config flag)
_includes/head/custom.html — Custom <head> content (UTF-8 charset)
assets/images/ — Static image assets (hero image, logo)

Deployment

GitHub Actions workflow (.github/workflows/build.yml):

Builds Jekyll site with JEKYLL_ENV=production and JEKYLL_URL=https://bovpro.com.br
Deploys _site/ to HostGator via FTP (SamKirkland/FTP-Deploy-Action@v4.3.5)
Requires repository secrets: FTP_SERVER, FTP_USERNAME, FTP_PASSWORD

FTP Configuration

The workflow uses these GitHub Secrets:

FTP_SERVER — FTP server hostname (e.g., ftp.veredaseburitis.com.br)
FTP_USERNAME — FTP account username (e.g., bovpro.com.br)
FTP_PASSWORD — FTP account password

To test FTP connection locally:

# Using lftp (recommended)
brew install lftp
lftp -u username ftp://hostname

# Or using sftp with password auth
sftp -o PreferredAuthentications=password -o PubkeyAuthentication=no user@hostname

Conventions

Script naming: run-[action].sh
File naming: kebab-case for content files
No custom Jekyll plugins (maintains GitHub Pages compatibility)
All content in Portuguese (PT-BR)
Links to external services (email, WhatsApp) in footer

Development Guidelines

Adding Content

Create markdown file in root (pages) or subdirectory (collections)
Include YAML frontmatter with layout and title

For splash layout (landing page), include header section with overlay:

header:
  overlay_color: "#2e7d32"
  overlay_filter: "0.5"
  overlay_image: /assets/images/hero-cattle.jpg
  actions:
    - label: "Button Text"
      url: "#section-id"

For feature rows, use the feature_row include in layout

Updating Configuration

After changing _config.yml, restart the development server:

# Kill server (Ctrl+C), then restart:
./run-dev.sh

Assets

Hero image: assets/images/hero-cattle.jpg (currently SVG placeholder)
Logo: To be added when available
All images should be optimized for web

Built Assets

The _site/ directory is generated by Jekyll:

Already in .gitignore — do not commit
Generated fresh on each build/deploy
Safe to delete and rebuild anytime

Testing

Local Testing

# Full build test
bundle exec jekyll build

# Development with live reload
./run-dev.sh

# Check for build warnings
bundle exec jekyll build 2>&1 | grep -i warning

Pre-Deployment Checklist

Run ./run-build.sh — no errors
Try ./run-dev.sh — renders correctly
Verify all pages: /, /about/, /bovpro/politica-de-privacidade.html, /404.html
Test responsive design (mobile/tablet/desktop)
Check all links (internal and external)
Verify Portuguese spelling

Contact & Branding

Email: bovpro@mutumsoft.com
WhatsApp: +55 61 9275-7212
Developer: Mutum Soft (https://mutumsoft.com.br)
Domain: bovpro.com.br
Base URL: / (root domain)

Known Issues / TODO

Hero image: Current hero-cattle.jpg is an SVG placeholder. Replace with real cattle/pasture photo.
Logo: Not yet added. Will be placed at assets/images/bovpro-logo.png when available.
App Store links: Currently show “Em breve”. Update when app is published.
index.markdown: Remove if still present (duplicate template file).
Gemfile.lock: Should be in .gitignore (for consistency with other projects).

mutumsoft_landing — Reference implementation (same theme, similar structure)
bovpro_app — Flutter mobile app (separate repo)
bovpro-api — Backend API (separate repo)

Quick Reference

Task	Command
Install deps	`./run-install.sh`
Dev server	`./run-dev.sh`
Build	`./run-build.sh`
Full build	`bundle exec jekyll build`
Check theme	`grep theme _config.yml`

Deployment Checklist (Full)

Before first production deployment:

Remove index.markdown (duplicate)
Update .gitignore to include Gemfile.lock, .DS_Store
Commit and push to main: git add . && git commit -m "feat: initial bovpro landing page" && git push
Configure FTP secrets in GitHub: https://github.com/tiagolpadua/bovpro_landing/settings/secrets/actions
Verify server-dir in workflow matches HostGator document root
Enable SSL/HTTPS on HostGator (Let’s Encrypt)
Run workflow manually and check logs
Verify site loads at https://bovpro.com.br
Test deploy automation (make change, push, verify auto-deploy)
No custom Jekyll plugins (maintains GitHub Pages compatibility)
Planning docs (PLANO_*.md) document project setup and deployment checklists