Expert guidance for working with Hugo static sites using the up-business-theme, including content management, deployment, and common workflows.
This skill provides expert guidance for working with Hugo static sites that use the "up-business-theme" for business/landing page layouts. It covers content management, theme customization, deployment, and common workflows.
This skill helps AI agents understand and work with Hugo-based business websites, specifically those using the up-business-theme pattern. It provides knowledge of:
When working with a Hugo business site following this architecture:
**Before making any changes**, familiarize yourself with these key directories:
- `homepage/` - Homepage section content
- `post/` - Blog posts
**To preview changes locally:**
```bash
hugo server
```
For sites with draft content:
```bash
hugo server -D
```
The site will be available at `http://localhost:1313` with live reload enabled.
**Homepage Content:**
**Blog Posts:**
```bash
hugo new content/post/my-post.md
```
**New Homepage Sections:**
```bash
hugo new content/homepage/section-name.md
```
**To update homepage hero section:**
**To modify site menus:**
**To change business info or social links:**
**To update theme:**
```bash
git submodule update --remote themes/up-business-theme
hugo server # Test locally before committing
```
**Images:**
**Static Files:**
**Standard build:**
```bash
hugo
```
**Minified build (recommended for production):**
```bash
hugo --minify
```
Output goes to `./public/` directory.
The project uses `.github/workflows/hugo.yml` for automatic deployment:
**To update Hugo version in CI/CD:**
**To override theme layouts:**
**Never edit theme files directly** - use layout overrides instead.
**Server not showing changes:**
**Theme not loading:**
```bash
git submodule update --init --recursive
```
**Build failing in GitHub Actions:**
**When cloning the repository:**
```bash
git clone --recurse-submodules <repo-url>
```
**If submodule is missing after clone:**
```bash
git submodule update --init --recursive
```
**When updating theme:**
```bash
git submodule update --remote themes/up-business-theme
git add themes/up-business-theme
git commit -m "Update theme submodule"
```
1. Edit `data/home/services.yaml`
2. Add new service entry with title, description, icon
3. Run `hugo server` to preview
4. Commit and push to trigger deployment
1. Run `hugo new content/post/my-article.md`
2. Edit front matter and content
3. Set `draft: false` when ready to publish
4. Test locally with `hugo server`
5. Commit and push
1. Place new logo in `assets/images/`
2. Update reference in `config.yaml` params section
3. Test with `hugo server`
4. Commit and push
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/hugo-business-site-guide/raw