Skip to content

AGENTS.md

Latest commit

 

History

History
43 lines (35 loc) · 2.29 KB

AGENTS.md

File metadata and controls

43 lines (35 loc) · 2.29 KB

Agent Notes: terraphim.ai

What this repo is

A Zola static site for https://terraphim.ai. No root Cargo.toml or package.json — the crates/ directory holds app config, not buildable Rust crates.

Daily commands

  • zola build — outputs to public/ (gitignored). Should complete in ~40ms.
  • zola serve — local dev server.
  • ./scripts/update-release.sh — fetches the latest GitHub release via gh and updates version strings across config.toml, content, and theme files. Run before zola build when a new release drops.

Deploy

  • Target: Cloudflare Pages.
  • Config: wrangler.toml (pages_build_output_dir = "public").
  • Command: wrangler pages deploy public/
  • Credentials live in .env.1password — never commit.

Version conventions

  • config.toml has two version fields:
    • extra.version — dev version (shown in nav badge).
    • extra.release_version — stable version (used in download URLs and JS platform detection).
  • scripts/update-release.sh only mutates release_version.

Theme architecture

  • Active theme: WarpDrive (defined in config.toml).
  • Theme files: themes/WarpDrive/templates/, themes/WarpDrive/static/, themes/WarpDrive/sass/.
  • Local template overrides go in templates/ (currently has a few macros and old backups).
  • Homepage is themes/WarpDrive/templates/index.html (large, ~36 KB); base layout is base.html.

Cleanup to know about

  • Old DeepThought theme still exists in themes/DeepThought/.
  • templates/*.deepthought-bak are leftover backups and safe to delete.
  • public/ is gitignored but may contain stale build output locally.

Content structure

  • content/_index.md — homepage frontmatter.
  • content/capabilities/ — feature pages linked from homepage waypoint cards.
  • content/docs/ — installation, quickstart.
  • content/posts/ — blog posts (no longer in nav, accessible via /posts/).
  • content/releases.md — release notes.

Editing constraints

  • The WarpDrive theme uses an OKLCH colour system. Accent colour is amber (oklch(0.72 0.16 70)). CSS variable names still say --warp-blue but values are amber.
  • Platform detection JS reads data-version from the install section and constructs GitHub asset URLs — keep release_version in sync with actual GitHub releases.