SquareCows Website

The official website for SquareCows (squarecows.com / sqcows.com), built with Hugo and the Hugo Up Business theme. SquareCows specializes in custom n8n workflow automations and enterprise integrations.

Tech Stack

• Hugo v0.152.2+ (extended version)
• Theme: hugo-up-business (git submodule)
• Styling: Tailwind CSS v4.0.0
• Node.js: For Tailwind CSS processing

Getting Started

Prerequisites

• Hugo v0.152.2+ extended edition
• Node.js and npm
• Go (required by theme)
• Git

Initial Setup

1. Clone the repository:

git clone <repository-url>
cd sqcows-web

2. Initialize and update git submodules (to pull the theme):

git submodule update --init --recursive

3. Install npm dependencies:

npm install

Development Mode

To run the development server with hot reloading:

npm run dev

This will start the Hugo development server at http://localhost:1313/ with:

• Automatic rebuilding on file changes
• Draft content included
• Tailwind CSS processing

Alternative Hugo commands:

# Direct Hugo server command
hugo server --buildDrafts

# Start on specific port
hugo server -p 1313

# Navigate to changed content automatically
hugo server --navigateToChanged

Configuration

Site configuration is in hugo.toml:

• Base URL and site title
• Theme selection
• Menu configuration
• Custom parameters (colors, contact info, etc.)

Customization

Editing Homepage Content

Homepage sections are controlled by YAML files in data/home/:

• hero.yaml: Main hero section
• services.yaml: Services section
• portfolio.yaml: Portfolio showcase
• testimonials.yaml: Customer testimonials

Custom Styling

Custom CSS is in assets/css/custom.css and uses Tailwind CSS v4.0.

Footer and Layout

Footer and other shared components are in layouts/partials/shared/.

Building for Production

To build the site for deployment to Amazon S3, Cloudflare R2, or any static hosting:

npm run build

This command:

• Runs hugo --minify to generate the static site
• Minifies HTML, CSS, and JavaScript
• Outputs all files to the public/ directory

The public/ folder will contain all static files ready for upload to:

• Amazon S3: Upload the contents of public/ to your S3 bucket
• Cloudflare R2: Upload the contents of public/ to your R2 bucket
• Any static host: Upload the contents of public/ to your hosting provider

Manual Build Options

# Build with minification (production)
hugo --minify

# Build with drafts included
hugo --buildDrafts

# Build to a custom output directory
hugo --destination /path/to/output

Project Structure

• content/: Markdown content files
• layouts/: Custom HTML templates (overrides theme layouts)
• static/: Static assets (images, favicon, etc.)
• assets/: Files processed by Hugo Pipes (CSS)
• data/home/: YAML files controlling homepage sections
• themes/hugo-up-business/: Hugo Up Business theme (git submodule)
• public/: Generated site output (created on build, git ignored)

Deployment

After building with npm run build, the public/ directory contains your complete static website. Upload this directory to your hosting provider:

Amazon S3

aws s3 sync public/ s3://your-bucket-name --delete

Cloudflare R2

# Use Wrangler CLI or R2 dashboard to upload the public/ directory
wrangler r2 object put your-bucket/public --file=public/ --recursive

Support

For issues or questions, contact info@sqcows.com

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

See LICENSE.md for the full license text.