wild-cloud/wild-website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e559603c49e5a3d7169f81f3d943d1d6d9dc80f1
wild-website/CLAUDE.md
Paul Payne e559603c49 Claude files.
2026-01-09 11:46:02 -08:00

3.6 KiB
Raw Blame History

CLAUDE.md

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

Project Overview

This is a Hugo static site for the Wild Cloud platform (mywildcloud.org) that serves multiple purposes:

  • Marketing and documentation website
  • APT repository for Debian packages
  • UI component distribution system
  • Community hub for the Wild Cloud ecosystem

Development Commands

Prerequisites

  • Install Hugo (minimum v0.87.0)
  • Install dart-sass

Development Server

hugo server -D

Build and Deploy

scripts/deploy.sh

The deploy script performs:

  1. hugo build - Generates static site in public/ directory
  2. docker build -t payneio/mywildcloud.org . - Creates Docker image with nginx:alpine
  3. docker push payneio/mywildcloud.org - Pushes to registry
  4. kubectl rollout restart deployment mywildcloud -n mywildcloud - Deploys to Kubernetes

Architecture

Theme Configuration

  • Theme: Blowfish v2+ (modern Hugo theme)
  • Color Scheme: "blowfish" with light default appearance
  • Layout: Custom homepage layout with basic header
  • Custom Assets: Wild Cloud logo and custom CSS in /assets/

Content Structure

  • Main Pages: Homepage, About, Get Started, Contribute
  • Additional Areas: Foundation, Learning, Projects (generated content)
  • Special Content: APT repository hosting and UI releases

Key Features

  • APT Repository: Complete Debian package repository in /static/apt/
    • Packages for wild-cloud-central (multiple versions, amd64/arm64)
    • GPG signing and repository metadata
    • Installation script (install-apt.sh)
  • UI Releases: Versioned UI component releases in /ui-releases/
    • JSON manifest with version, archive URLs, and checksums
  • Analytics: Google Analytics integration (G-YSHP7PL9R1)
  • SEO: XML sitemap, robots.txt, and meta tags configured

Configuration Files

  • Hugo Config: config/_default/hugo.toml - Main site configuration
  • Theme Config: config/_default/params.toml - Blowfish theme settings
  • Menus: config/_default/menus.en.toml - Navigation structure
  • Markup: config/_default/markup.toml - Content rendering options

Deployment Architecture

  • Development: Local Hugo server with draft content
  • Production: Containerized deployment using Docker + Kubernetes
  • Base URL: https://www.mywildcloud.org/
  • Container: nginx:alpine serving static files from /usr/share/nginx/html

Theme Customization

Custom CSS

  • Location: /assets/css/custom.css
  • Custom font implementation and Wild Cloud branding

Custom Layouts

  • Homepage override: /layouts/home.html
  • Uses basic header layout instead of default theme layout

Theme Features Configuration

  • Enabled: Search, auto appearance switching, breadcrumbs, table of contents
  • Disabled: Author info, dates, views, likes, comments
  • Analytics: Google Analytics integration
  • Social: Meta tags and social sharing configured

Content Management

Taxonomies

  • Tags, categories, authors, series
  • Weighted related content indices

Content Types

  • Standard markdown pages
  • Foundation/principles content
  • Learning resources
  • Project documentation
  • Package repository metadata

Important Notes

  • The site doubles as a software distribution platform with integrated APT repository
  • All content changes require rebuilding and redeploying the Docker container
  • The Kubernetes deployment uses rolling updates for zero-downtime deployments
  • Package distribution is handled through static file serving from /static/apt/
  • UI releases are distributed via JSON manifest and tarball system