Isometria

Interactive isometric three.js island with day/night.

Live demo  ·  Build notes  ·  More templates

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

npx degit bswxyz/formwork-isometria my-app

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

A cosy toy-box island in three.js: drag to spin, hover to raise tiles, flip day to night.

A free, MIT-licensed website template. Good for: game studios, cosy games, playful portfolios, kids' brands. The demo brand ("ISOMETRIA") is fictional — every word and colour is meant to be replaced with yours.

The signature technique

• Procedurally generated tile island (orthographic camera = true isometric)
• Raycaster hover lifts tiles; pointer drag spins the world; day/night relights the scene
• Soft PCF shadows, swaying trees, glowing lighthouse lamp

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 like — my-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-isometria --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

• Island shape: levelAt() height function + COLORS per elevation in main.js
• Games: the four cards each set a --c accent — swap titles and colours
• Day/night: tweak the two lighting states in setNight()

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 →