hyperhive/website
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

initial landing scaffold (hyperhive/website MVP)

Browse source 
Tracks hyperhive#502 — landing-only first cut. Static site
generator: Zola (Rust, fits the swarm's stack and the operator's
"sounds exciting" go-ahead on the issue thread).

## Structure

- `flake.nix` — `nix build .#website` produces the dist; `nix
  develop` drops into a shell with zola for `zola serve` live
  reload. No CI runner; the flake is the validation contract.
- `config.toml` — Zola config; base URL `hyperhive.darkest.space`
  per #502. Single-page landing — feeds / search index off.
- `content/_index.md` — landing copy. Editable without touching
  templates so non-engineers can refresh prose.
- `templates/base.html` + `templates/index.html` — base layout +
  landing-specific extension. og:tags + favicon wired through.
- `sass/main.scss` — theme. Catppuccin Mocha palette + the amber
  accent from the swarm's identity hex mark. Self-contained
  (no @import) so the file is reviewable in one place.
- `static/{favicon,hex-mark,hyperhive}.svg` — copies of the
  dashboard's `branding/hyperhive.svg` (hex motif). Used as
  favicon, hero inline, and og:image respectively.

## Theme

Monospace identity throughout — matches dashboard / agent
terminals so the website reads as part of the same family
rather than a separate marketing artifact. Banner glyphs
(`░▒▓█▓▒░`) on the title, dashed dividers, cyan/mauve/amber
accents, glow text-shadow on the hero. Subtle CSS-only pulse
on the hex motif (slow `rotate` on the SVG; speeds up on hover
for a small "noticed" cue).

## Three-column "what's inside"

`the swarm` / `the dashboard` / `the boundary` — quick
orientation for visitors who clicked through from a link
without context. Copy intentionally short; deep dives belong
in /docs (future, not in this MVP).

## Scope drop

Per mara on #502:
- no nav / blog / docs yet — landing only
- no screenshots in MVP, follow via issues in this repo
- public visibility

## Provenance

Scaffolded under `iris/website` because my agent forge token
doesn't carry org-admin to create repos under `hyperhive/`.
Manager confirmed their token doesn't either; mara will do the
org transfer once she gets to it. README documents this.
This commit is contained in:
iris 2026-05-27 10:08:56 +02:00
parent b1dd949291
commit d3a55c5631
12 changed files with 873 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

34
templates/base.html Normal file
View file

@ -0,0 +1,34 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{% block title %}{{ config.title }}{% endblock %}</title>
<meta name="description" content="{{ config.description }}">
{# Open Graph / social card. Reuses the SVG hex mark as the image. #}
<meta property="og:type" content="website">
<meta property="og:title" content="{{ config.title }}">
<meta property="og:description" content="{{ config.description }}">
<meta property="og:url" content="{{ config.base_url }}">
<meta property="og:image" content="{{ get_url(path='hyperhive.svg') }}">
<meta name="twitter:card" content="summary_large_image">
<link rel="icon" type="image/svg+xml" href="{{ get_url(path='favicon.svg') }}">
<link rel="stylesheet" href="{{ get_url(path='main.css') }}">
</head>
<body>
<main class="shell">
{% block content %}{% endblock %}
</main>
<footer class="site-footer">
<pre class="banner-thin">░▒▓█▓▒░ HYPERHIVE ░▒▓█▓▒░</pre>
<p class="footer-links">
<a href="http://localhost:3000/hyperhive">code on the forge</a>
<span class="sep">·</span>
<a href="{{ get_url(path='') }}">home</a>
</p>
</footer>
</body>
</html>

64
templates/index.html Normal file
View file

@ -0,0 +1,64 @@
{% extends "base.html" %}
{% block content %}
{# Hero — hex motif left, headline + tagline + CTA right. Stacks
vertically on narrow viewports via the .hero CSS grid. #}
<section class="hero">
<div class="hero-art" aria-hidden="true">
{# Inline so the SVG inherits the page's font + can be styled
(hover pulse animation on the rings). Same source as the
dashboard branding/hyperhive.svg. #}
{% set hex_svg = load_data(path="hex-mark.svg") %}
{{ hex_svg | safe }}
</div>
<div class="hero-text">
<h1>
<span class="banner-glyph">░▒▓</span>
hyperhive
<span class="banner-glyph">▓▒░</span>
</h1>
<p class="hero-tagline">{{ config.description }}</p>
<p class="hero-cta">
<a class="cta-primary" href="http://localhost:3000/hyperhive/hyperhive">
◆ explore the code →
</a>
</p>
</div>
</section>
{# Landing prose — pulled from _index.md so non-engineers can edit
copy without touching templates. #}
<section class="prose">
{{ section.content | safe }}
</section>
{# Three-column "what's inside" — quick orientation for visitors
who clicked through from a link without context. Copy here is
intentionally short; deep dives belong in /docs (future). #}
<section class="grid-3">
<article class="card">
<h2><span class="card-glyph">▣</span> the swarm</h2>
<p>
Each agent is a NixOS container with its own claude session,
a logical name, and a parent in the topology tree. Containers
come and go; the topology is the operator's facts file.
</p>
</article>
<article class="card">
<h2><span class="card-glyph">⟁</span> the dashboard</h2>
<p>
One web page shows live agent state, the broker stream, the
approval queue, scheduled prompts, and the rebuild pipeline.
Everything that mutates the swarm passes through here.
</p>
</article>
<article class="card">
<h2><span class="card-glyph">◇</span> the boundary</h2>
<p>
Agents can ask, schedule, request approvals, and message peers
— but never spawn / destroy / mutate config themselves. Those
actions queue up and wait on the human at the dashboard.
</p>
</article>
</section>
{% endblock %}