Skip to content

README.md

Latest commit

 

History

History
54 lines (37 loc) · 2.18 KB

README.md

File metadata and controls

54 lines (37 loc) · 2.18 KB
Raw

Watch Demo

Algorithmic Visual Evolution

A modular, browser-based system for evolving algorithmic visuals: parameter-driven feedback, macros, and GPU-backed rendering.

Branches

Branch Role
main Default branch. Full TypeScript app, compiled output in dist/, optional regl / WebGL path (index.regl.html, regl_dist/), JSON presets, and shader sources under src/. Clone or pull main for day-to-day use.
lite Same tree as main after the repo was standardized (kept for existing links and checkouts; you can use either).

The original JavaScript-only prototype is still in history at commit a555957, and as the git tag js-baseline (use git checkout js-baseline to browse that snapshot).

Quick start

Requirements: Node.js and npm.

git clone <your-repo-url>
cd algorithmic-visual-evolution
npm install
npm run dev

Then open the URL printed by live-server (often http://127.0.0.1:8080). The default index.html loads dist/app.js; dist/ is checked in, so you can run without compiling first.

To rebuild TypeScript after editing .ts files:

npx tsc

Scripts

Script Purpose
npm run dev Serves the project with live-server (default entry: index.html).
npm run dev:ts Cleans dist/, runs tsc, fixes ESM import paths, then opens index.html in the browser.
npm run dev:js Populates dist/ from legacy JS sources (if present) and opens the app.
npm run dev:regl Compiles src/app.ts into regl_dist/ and serves index.regl.html.
npm run switch Runs switch-version.js — pass js or ts (see script help).

Repository layout

  • app.ts, config.ts, algorithms/, utils/ — application and modules (compiled to dist/).
  • src/ — additional TypeScript and GLSL shaders used by the regl pipeline.
  • presets/ — saved parameter presets (JSON).
  • switch-version.js — switches between JS and TS build outputs for local dev.

License

See LICENSE (ISC).