Skip to content

Explorables treatment for evo docs (port fugue's interactive doc system) #12

Description

@alexnodeland

The evo docs site (evo.fugue.run) is a plain static mdBook — default rust/ayu theme, no interactive widgets, none of the explorables design system that shipped to fugue.run in alexnodeland/fugue#39.

Scope

  • Port the shared viz foundation from fugue (docs/fugue-viz.js + fugue-viz.css): seeded rng, lazy init via IntersectionObserver, autoplay-on-scroll / pause-offscreen, touch handling via the shared drag manager (canvases default pan-y), theme via --bg token luminance, navy theme in book.toml.
  • Evo-specific explorables (data-first law applies: every widget shows a live distribution/population over real data, not machinery diagrams):
    • fitness landscape with a live CMA-ES covariance ellipse adapting
    • island model — populations diverging and migration events reseeding
    • Pareto front forming live for NSGA-II
    • selection/crossover/mutation on a real population, generation by generation
    • diversity / convergence diagnostics as ambient micro-widgets through the tutorials
  • Ambient micro-widgets embedded at point-of-discussion across the 8 tutorials + how-to pages (the inline.js pattern).
  • Cleanup: docs/src/api-docs.md still says docs.rs "(when published)" — it is published and built (docs.rs/fugue-evo, 0.1.0); link it as live.

Design references

🤖 Generated with Claude Code

https://claude.ai/code/session_018yo1jdkckG7yQ9eBqLbaDB

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions