Skip to content

bswxyz/formwork-algorithm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Algorithm

Generative-art gallery with a seeded flow field.

Live demo Family Stack MIT License

Live demo  ·  Build notes  ·  More templates

Algorithm — live preview

Use this template — copy the source into a new project:

npx degit bswxyz/formwork-algorithm my-app

Live demo → https://bswxyz.github.io/formwork-algorithm/ · How it was built

Code-drawn art that renders unique on every visit — seeded, reproducible via ?seed= in the URL.

A free, MIT-licensed website template. Good for: generative artists, creative coders, NFT/plot artists, galleries. The demo brand ("ALGORITHM") is fictional — every word and colour is meant to be replaced with yours.

The signature technique

  • Flow field: thousands of particles advected through seeded noise, leaving ink-like trails
  • Seed system: mulberry32 PRNG drives field + per-seed accent palette; Regenerate & Copy-link controls
  • Three extra gallery algorithms (circle packing, Truchet tiles, attractor), each captioned like an artwork

Use this as your own site

This repo is a template — everything is plain HTML/CSS/JS with relative paths, so it works under any repo name with zero configuration.

  1. Click Use this template → Create a new repository (top of this page). Name it whatever you likemy-site, portfolio, anything.
  2. In your new repo: Settings → Pages → Build and deployment → Deploy from a branch, then pick main / / (root) and save. (CLI: see below.)
  3. Wait ~1 minute. Your site is live at https://YOUR-USERNAME.github.io/YOUR-REPO-NAME/.
Prefer the command line?
gh repo create my-site --template bswxyz/formwork-algorithm --public --clone
cd my-site
gh api --method POST /repos/YOUR-USERNAME/my-site/pages \
  -f 'source[branch]=main' -f 'source[path]=/'

No build step, no dependencies to install — edit the files, push, done. The only external requests are Google Fonts and (where used) pinned CDN copies of GSAP/three.js.

Customize it

  • Algorithms: each gallery piece is a self-contained function in main.js — swap in your own
  • Field look: particle count, step length and fade alpha are constants up top
  • Wordmark/serif: Fraunces + Space Mono, set in styles.css

The /guide/ page documents the signature technique in depth (with code) — keep it, rewrite it, or delete the folder entirely.

Files

index.html        the page
styles.css        all styling (design tokens in :root at the top)
main.js           the signature effect + motion
guide/index.html  how-it-works write-up (optional — yours to keep or delete)

Built-in quality

  • Works with JS disabled or a CDN failure (content is never permanently hidden)
  • Respects prefers-reduced-motion; keyboard focus styles throughout
  • Canvas/WebGL feature-detected with graceful fallbacks; devicePixelRatio capped for performance
  • Responsive at phone / tablet / desktop widths

License & credit

MIT — free for personal and commercial use, no attribution required (a link back is always appreciated). Part of FORMWORK — a collection of 25 free website templates: the full gallery →

About

Free website template — generative-art gallery with a seeded flow field. MIT, no build step, ready for GitHub Pages. Demo + build guide inside.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors