{
  "schemaVersion": 1,
  "id": "mobius-flow",
  "version": "1.0.0",
  "status": "published",
  "kind": "object",
  "title": "Möbius Flow",
  "summary": "A glass Möbius strip with a glowing edge and a river of beads that takes two laps to get home. Loops perfectly.",
  "description": "A Möbius strip: a band with one half-twist, so it has only one side and one edge. A river of glowing beads runs along it in lanes, and because the strip is one-sided every bead makes two laps to come back to where it began, passing from what looks like the top to what looks like the bottom and back. The glass-like strip turns slowly while its single edge glows. Choose the number of beads, the colours (aurora, ember, pearl or mono), the width of the strip, how many double laps the beads make per loop, the turns of the strip, the seed, the backdrop colour and whether the camera sways.",
  "role": "Object (3D, three.js): a topology showpiece with a satisfying flow, for maths, science and abstract design content.",
  "collections": [
    "chrome-glass",
    "hypnotic-loops",
    "particles"
  ],
  "tags": [
    "mobius strip",
    "one-sided surface",
    "topology",
    "flow",
    "beads",
    "glass",
    "edge glow",
    "mathematics",
    "studio",
    "loop",
    "3d"
  ],
  "synonyms": [
    "moebius strip",
    "mobius band",
    "one-sided band",
    "infinity loop",
    "twisted band",
    "topological strip"
  ],
  "useCases": [
    "A maths or topology explainer",
    "An infinity or endless-loop brand scene",
    "A soothing particle-flow loop"
  ],
  "featured": null,
  "publishedAt": "2026-10-05",
  "implementation": {
    "target": "three",
    "runtime": "browser",
    "language": "javascript",
    "module": "esm",
    "entry": "src/mobius-flow.js",
    "exports": [
      {
        "name": "createMobiusFlow",
        "signature": "createMobiusFlow({ beads?, palette?, width?, laps?, turns?, seed? }) => { group, setProgress(progress), dispose() }",
        "description": "The strip, its glowing edge and the beads as a group about 6 across, centred on the origin; needs an environment map."
      },
      {
        "name": "PALETTES",
        "signature": "PALETTES: { aurora, ember, pearl, mono }",
        "description": "Colours for the strip, the beads and the edge."
      }
    ],
    "reusable": [
      "src/mobius-flow.js"
    ],
    "demo": "demo.js",
    "harness": "index.html"
  },
  "dependencies": [
    {
      "id": "three",
      "version": "0.185.1",
      "reason": "Renderer, geometry and shader materials."
    },
    {
      "id": "chrome-material",
      "version": "1.1.0",
      "scope": "demo",
      "reason": "Studio environment light, backdrop and contact shadow."
    },
    {
      "id": "apw-runtime",
      "version": "1.0.0",
      "scope": "demo",
      "reason": "Demo harness."
    }
  ],
  "params": [
    {
      "key": "beads",
      "label": "Beads",
      "type": "integer",
      "min": 20,
      "max": 300,
      "step": 10,
      "default": 120
    },
    {
      "key": "palette",
      "label": "Colours",
      "type": "select",
      "default": "aurora",
      "options": [
        {
          "value": "aurora",
          "label": "Aurora"
        },
        {
          "value": "ember",
          "label": "Ember"
        },
        {
          "value": "pearl",
          "label": "Pearl"
        },
        {
          "value": "mono",
          "label": "Mono"
        }
      ]
    },
    {
      "key": "width",
      "label": "Strip width",
      "type": "number",
      "min": 0.6,
      "max": 1.4,
      "step": 0.1,
      "default": 1
    },
    {
      "key": "laps",
      "label": "Double laps per loop",
      "type": "integer",
      "min": 1,
      "max": 3,
      "step": 1,
      "default": 1
    },
    {
      "key": "turns",
      "label": "Strip turns per loop",
      "type": "integer",
      "min": 0,
      "max": 3,
      "step": 1,
      "default": 1
    },
    {
      "key": "seed",
      "label": "Seed",
      "type": "integer",
      "min": 1,
      "max": 999,
      "step": 1,
      "default": 10
    },
    {
      "key": "background",
      "label": "Backdrop",
      "type": "color",
      "default": "#10141f"
    },
    {
      "key": "orbit",
      "label": "Camera sway",
      "type": "boolean",
      "default": true
    }
  ],
  "presets": [
    {
      "id": "default",
      "label": "Aurora, 120 beads",
      "params": {}
    },
    {
      "id": "ember",
      "label": "Ember, wide",
      "params": {
        "palette": "ember",
        "width": 1.4,
        "beads": 200,
        "background": "#1c1210"
      }
    },
    {
      "id": "pearl",
      "label": "Pearl, two laps",
      "params": {
        "palette": "pearl",
        "laps": 2,
        "background": "#1c1c28"
      }
    },
    {
      "id": "mono",
      "label": "Mono, still strip",
      "params": {
        "palette": "mono",
        "turns": 0,
        "beads": 60,
        "background": "#14161c"
      }
    }
  ],
  "output": {
    "width": 1080,
    "height": 1080,
    "fps": 30,
    "durationSeconds": 16,
    "posterSeconds": 4,
    "alpha": false,
    "motion": "procedural",
    "loop": {
      "seamless": true,
      "cycleSeconds": 16,
      "method": "Each bead makes a whole number of double laps (it comes back to the same place after two turns round a one-sided strip), the strip turns a whole number of times per loop and the camera sway is a sine of the loop, so the last frame meets the first."
    },
    "seed": {
      "param": "seed",
      "behavior": "Seed places the beads across the strip's lanes and gives them sizes and speeds: same seed, same river."
    }
  },
  "composition": {
    "inputs": "Time within the loop; the beads, colours, width, laps, turns, seed, backdrop and camera sway.",
    "outputs": "A full frame rendered in 3D with a studio environment.",
    "coordinates": "The strip's core circle has radius 2.2 and it is hung 3.3 above the floor; its half-width is 0.95 × the width setting.",
    "lighting": "A warm key light with a shadow map and the studio environment on the glass; the beads and edge are self-lit.",
    "timing": "setProgress(progress) places every bead and turns the group; frames render in any order.",
    "compatibleWith": [
      "chrome-material",
      "orbit-camera",
      "kinetic-title",
      "number-reveal"
    ],
    "notes": [
      "A bead's position after two turns round (u + 4π) is the same as its start, so beads make double laps; the edge curve is a single closed line of length 4π."
    ]
  },
  "reuse": [
    "Infinity brand: Aurora, 120 beads.",
    "Warm: Ember, wide.",
    "Calm: Pearl, two laps."
  ],
  "integration": {
    "newProject": "Create a WebGLRenderer with a studio environment, add createMobiusFlow().group and call strip.setProgress(progress) each frame.",
    "existingProject": "Copy src/mobius-flow.js; add the group to your scene with an environment map."
  },
  "performance": {
    "notes": "A static mesh of about 6 000 triangles, a line and up to 300 instanced beads with a shadow map: a couple of milliseconds a frame on an integrated Intel GPU.",
    "limits": "Software WebGL renders in about two seconds a frame."
  },
  "limitations": [
    "The strip is translucent without true refraction; beads show through it.",
    "A faint seam can show where the strip's ends join."
  ],
  "license": {
    "spdx": "MIT",
    "notice": "Copyright (c) 2026 AI Pixel Wizard. Released under the MIT License. See LICENSE in this folder.",
    "thirdParty": []
  },
  "provenance": "Adapted from the owner's threejs-sketches/geometry-math/mobius-flow (MIT) and rebuilt for AI Pixel Wizard in October 2026 as an original studio object: a translucent iridescent strip, its single glowing edge and beads on lanes making double laps with a whole-turn rotation, on an exact loop.",
  "changelog": [
    {
      "version": "1.0.0",
      "date": "2026-10-05",
      "notes": "Initial release."
    }
  ]
}