From 6dc1ac4962182c8deee41a5b87d0942334e4f7d8 Mon Sep 17 00:00:00 2001
From: Utkarsh-Singhal-26 <singhalutkarsh26@gmail.com>
Date: Mon, 21 Jul 2025 10:24:33 +0530
Subject: [PATCH] Added <Galaxy /> background

---
 src/constants/Categories.ts                  |   5 +-
 src/constants/Components.ts                  |   1 +
 src/constants/code/Backgrounds/galaxyCode.ts |  28 ++
 src/content/Backgrounds/Galaxy/Galaxy.vue    | 357 +++++++++++++++++++
 src/demo/Backgrounds/GalaxyDemo.vue          | 182 ++++++++++
 5 files changed, 571 insertions(+), 2 deletions(-)
 create mode 100644 src/constants/code/Backgrounds/galaxyCode.ts
 create mode 100644 src/content/Backgrounds/Galaxy/Galaxy.vue
 create mode 100644 src/demo/Backgrounds/GalaxyDemo.vue

diff --git a/src/constants/Categories.ts b/src/constants/Categories.ts
index a71d25e..3227adc 100644
--- a/src/constants/Categories.ts
+++ b/src/constants/Categories.ts
@@ -1,5 +1,5 @@
 // Highlighted sidebar items
-export const NEW = ['Target Cursor', 'Ripple Grid', 'Magic Bento'];
+export const NEW = ['Target Cursor', 'Ripple Grid', 'Magic Bento', 'Galaxy'];
 export const UPDATED = [];
 
 // Used for main sidebar navigation
@@ -103,7 +103,8 @@ export const CATEGORIES = [
       'Orb',
       'Ballpit',
       'Liquid Chrome',
-      'Grid Distortion'
+      'Grid Distortion',
+      'Galaxy',
     ]
   }
 ];
diff --git a/src/constants/Components.ts b/src/constants/Components.ts
index 83b7d15..05ddf75 100644
--- a/src/constants/Components.ts
+++ b/src/constants/Components.ts
@@ -90,6 +90,7 @@ const backgrounds = {
   'liquid-chrome': () => import('../demo/Backgrounds/LiquidChromeDemo.vue'),
   'grid-distortion': () => import('../demo/Backgrounds/GridDistortionDemo.vue'),
   'ripple-grid': () => import('../demo/Backgrounds/RippleGridDemo.vue'),
+  'galaxy': () => import('../demo/Backgrounds/GalaxyDemo.vue'),
 };
 
 export const componentMap = {
diff --git a/src/constants/code/Backgrounds/galaxyCode.ts b/src/constants/code/Backgrounds/galaxyCode.ts
new file mode 100644
index 0000000..08e5f66
--- /dev/null
+++ b/src/constants/code/Backgrounds/galaxyCode.ts
@@ -0,0 +1,28 @@
+import code from '@content/Backgrounds/Galaxy/Galaxy.vue?raw';
+import { createCodeObject } from '../../../types/code';
+
+export const galaxy = createCodeObject(code, 'Backgrounds/Galaxy', {
+  installation: `npm install ogl`,
+  usage: `<template>
+  // Basic usage
+  <div class="relative w-full h-[600px]">
+    <Galaxy />
+  </div>
+  
+  // With custom prop values
+  <div class="relative w-full h-[600px]">
+    <Galaxy 
+      :mouse-repulsion="true"
+      :mouse-interaction="true"
+      :density="1.5"
+      :glow-intensity="0.5"
+      :saturation="0.8"
+      :hue-shift="240"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+  import Galaxy from "./Galaxy.vue";
+</script>`
+});
diff --git a/src/content/Backgrounds/Galaxy/Galaxy.vue b/src/content/Backgrounds/Galaxy/Galaxy.vue
new file mode 100644
index 0000000..f201bf3
--- /dev/null
+++ b/src/content/Backgrounds/Galaxy/Galaxy.vue
@@ -0,0 +1,357 @@
+<script setup lang="ts">
+import { Renderer, Program, Mesh, Color, Triangle } from 'ogl';
+import { onMounted, onUnmounted, ref, useTemplateRef, watch } from 'vue';
+
+const vertexShader = `
+attribute vec2 uv;
+attribute vec2 position;
+
+varying vec2 vUv;
+
+void main() {
+  vUv = uv;
+  gl_Position = vec4(position, 0, 1);
+}
+`;
+
+const fragmentShader = `
+precision highp float;
+
+uniform float uTime;
+uniform vec3 uResolution;
+uniform vec2 uFocal;
+uniform vec2 uRotation;
+uniform float uStarSpeed;
+uniform float uDensity;
+uniform float uHueShift;
+uniform float uSpeed;
+uniform vec2 uMouse;
+uniform float uGlowIntensity;
+uniform float uSaturation;
+uniform bool uMouseRepulsion;
+uniform float uTwinkleIntensity;
+uniform float uRotationSpeed;
+uniform float uRepulsionStrength;
+uniform float uMouseActiveFactor;
+uniform float uAutoCenterRepulsion;
+uniform bool uTransparent;
+
+varying vec2 vUv;
+
+#define NUM_LAYER 4.0
+#define STAR_COLOR_CUTOFF 0.2
+#define MAT45 mat2(0.7071, -0.7071, 0.7071, 0.7071)
+#define PERIOD 3.0
+
+float Hash21(vec2 p) {
+  p = fract(p * vec2(123.34, 456.21));
+  p += dot(p, p + 45.32);
+  return fract(p.x * p.y);
+}
+
+float tri(float x) {
+  return abs(fract(x) * 2.0 - 1.0);
+}
+
+float tris(float x) {
+  float t = fract(x);
+  return 1.0 - smoothstep(0.0, 1.0, abs(2.0 * t - 1.0));
+}
+
+float trisn(float x) {
+  float t = fract(x);
+  return 2.0 * (1.0 - smoothstep(0.0, 1.0, abs(2.0 * t - 1.0))) - 1.0;
+}
+
+vec3 hsv2rgb(vec3 c) {
+  vec4 K = vec4(1.0, 2.0 / 3.0, 1.0 / 3.0, 3.0);
+  vec3 p = abs(fract(c.xxx + K.xyz) * 6.0 - K.www);
+  return c.z * mix(K.xxx, clamp(p - K.xxx, 0.0, 1.0), c.y);
+}
+
+float Star(vec2 uv, float flare) {
+  float d = length(uv);
+  float m = (0.05 * uGlowIntensity) / d;
+  float rays = smoothstep(0.0, 1.0, 1.0 - abs(uv.x * uv.y * 1000.0));
+  m += rays * flare * uGlowIntensity;
+  uv *= MAT45;
+  rays = smoothstep(0.0, 1.0, 1.0 - abs(uv.x * uv.y * 1000.0));
+  m += rays * 0.3 * flare * uGlowIntensity;
+  m *= smoothstep(1.0, 0.2, d);
+  return m;
+}
+
+vec3 StarLayer(vec2 uv) {
+  vec3 col = vec3(0.0);
+
+  vec2 gv = fract(uv) - 0.5; 
+  vec2 id = floor(uv);
+
+  for (int y = -1; y <= 1; y++) {
+    for (int x = -1; x <= 1; x++) {
+      vec2 offset = vec2(float(x), float(y));
+      vec2 si = id + vec2(float(x), float(y));
+      float seed = Hash21(si);
+      float size = fract(seed * 345.32);
+      float glossLocal = tri(uStarSpeed / (PERIOD * seed + 1.0));
+      float flareSize = smoothstep(0.9, 1.0, size) * glossLocal;
+
+      float red = smoothstep(STAR_COLOR_CUTOFF, 1.0, Hash21(si + 1.0)) + STAR_COLOR_CUTOFF;
+      float blu = smoothstep(STAR_COLOR_CUTOFF, 1.0, Hash21(si + 3.0)) + STAR_COLOR_CUTOFF;
+      float grn = min(red, blu) * seed;
+      vec3 base = vec3(red, grn, blu);
+      
+      float hue = atan(base.g - base.r, base.b - base.r) / (2.0 * 3.14159) + 0.5;
+      hue = fract(hue + uHueShift / 360.0);
+      float sat = length(base - vec3(dot(base, vec3(0.299, 0.587, 0.114)))) * uSaturation;
+      float val = max(max(base.r, base.g), base.b);
+      base = hsv2rgb(vec3(hue, sat, val));
+
+      vec2 pad = vec2(tris(seed * 34.0 + uTime * uSpeed / 10.0), tris(seed * 38.0 + uTime * uSpeed / 30.0)) - 0.5;
+
+      float star = Star(gv - offset - pad, flareSize);
+      vec3 color = base;
+
+      float twinkle = trisn(uTime * uSpeed + seed * 6.2831) * 0.5 + 1.0;
+      twinkle = mix(1.0, twinkle, uTwinkleIntensity);
+      star *= twinkle;
+      
+      col += star * size * color;
+    }
+  }
+
+  return col;
+}
+
+void main() {
+  vec2 focalPx = uFocal * uResolution.xy;
+  vec2 uv = (vUv * uResolution.xy - focalPx) / uResolution.y;
+
+  vec2 mouseNorm = uMouse - vec2(0.5);
+  
+  if (uAutoCenterRepulsion > 0.0) {
+    vec2 centerUV = vec2(0.0, 0.0); // Center in UV space
+    float centerDist = length(uv - centerUV);
+    vec2 repulsion = normalize(uv - centerUV) * (uAutoCenterRepulsion / (centerDist + 0.1));
+    uv += repulsion * 0.05;
+  } else if (uMouseRepulsion) {
+    vec2 mousePosUV = (uMouse * uResolution.xy - focalPx) / uResolution.y;
+    float mouseDist = length(uv - mousePosUV);
+    vec2 repulsion = normalize(uv - mousePosUV) * (uRepulsionStrength / (mouseDist + 0.1));
+    uv += repulsion * 0.05 * uMouseActiveFactor;
+  } else {
+    vec2 mouseOffset = mouseNorm * 0.1 * uMouseActiveFactor;
+    uv += mouseOffset;
+  }
+
+  float autoRotAngle = uTime * uRotationSpeed;
+  mat2 autoRot = mat2(cos(autoRotAngle), -sin(autoRotAngle), sin(autoRotAngle), cos(autoRotAngle));
+  uv = autoRot * uv;
+
+  uv = mat2(uRotation.x, -uRotation.y, uRotation.y, uRotation.x) * uv;
+
+  vec3 col = vec3(0.0);
+
+  for (float i = 0.0; i < 1.0; i += 1.0 / NUM_LAYER) {
+    float depth = fract(i + uStarSpeed * uSpeed);
+    float scale = mix(20.0 * uDensity, 0.5 * uDensity, depth);
+    float fade = depth * smoothstep(1.0, 0.9, depth);
+    col += StarLayer(uv * scale + i * 453.32) * fade;
+  }
+
+  if (uTransparent) {
+    float alpha = length(col);
+    alpha = smoothstep(0.0, 0.3, alpha); // Enhance contrast
+    alpha = min(alpha, 1.0); // Clamp to maximum 1.0
+    gl_FragColor = vec4(col, alpha);
+  } else {
+    gl_FragColor = vec4(col, 1.0);
+  }
+}
+`;
+
+interface GalaxyProps {
+  focal?: [number, number];
+  rotation?: [number, number];
+  starSpeed?: number;
+  density?: number;
+  hueShift?: number;
+  disableAnimation?: boolean;
+  speed?: number;
+  mouseInteraction?: boolean;
+  glowIntensity?: number;
+  saturation?: number;
+  mouseRepulsion?: boolean;
+  twinkleIntensity?: number;
+  rotationSpeed?: number;
+  repulsionStrength?: number;
+  autoCenterRepulsion?: number;
+  transparent?: boolean;
+}
+
+const props = withDefaults(defineProps<GalaxyProps>(), {
+  focal: () => [0.5, 0.5],
+  rotation: () => [1.0, 0.0],
+  starSpeed: 0.5,
+  density: 1,
+  hueShift: 140,
+  disableAnimation: false,
+  speed: 1.0,
+  mouseInteraction: true,
+  glowIntensity: 0.3,
+  saturation: 0.0,
+  mouseRepulsion: true,
+  twinkleIntensity: 0.3,
+  rotationSpeed: 0.1,
+  repulsionStrength: 2,
+  autoCenterRepulsion: 0,
+  transparent: true
+});
+
+const ctnDom = useTemplateRef('ctnDom');
+const targetMousePos = ref({ x: 0.5, y: 0.5 });
+const smoothMousePos = ref({ x: 0.5, y: 0.5 });
+const targetMouseActive = ref(0.0);
+const smoothMouseActive = ref(0.0);
+
+let cleanup: (() => void) | null = null;
+
+const setup = () => {
+  if (!ctnDom.value) return;
+  const ctn = ctnDom.value;
+  const renderer = new Renderer({
+    alpha: props.transparent,
+    premultipliedAlpha: false
+  });
+  const gl = renderer.gl;
+
+  if (props.transparent) {
+    gl.enable(gl.BLEND);
+    gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA);
+    gl.clearColor(0, 0, 0, 0);
+  } else {
+    gl.clearColor(0, 0, 0, 1);
+  }
+
+  let program: Program;
+
+  function resize() {
+    const scale = 1;
+    renderer.setSize(ctn.offsetWidth * scale, ctn.offsetHeight * scale);
+    if (program) {
+      program.uniforms.uResolution.value = new Color(
+        gl.canvas.width,
+        gl.canvas.height,
+        gl.canvas.width / gl.canvas.height
+      );
+    }
+  }
+  window.addEventListener('resize', resize, false);
+  resize();
+
+  const geometry = new Triangle(gl);
+  program = new Program(gl, {
+    vertex: vertexShader,
+    fragment: fragmentShader,
+    uniforms: {
+      uTime: { value: 0 },
+      uResolution: {
+        value: new Color(gl.canvas.width, gl.canvas.height, gl.canvas.width / gl.canvas.height)
+      },
+      uFocal: { value: new Float32Array(props.focal) },
+      uRotation: { value: new Float32Array(props.rotation) },
+      uStarSpeed: { value: props.starSpeed },
+      uDensity: { value: props.density },
+      uHueShift: { value: props.hueShift },
+      uSpeed: { value: props.speed },
+      uMouse: {
+        value: new Float32Array([smoothMousePos.value.x, smoothMousePos.value.y])
+      },
+      uGlowIntensity: { value: props.glowIntensity },
+      uSaturation: { value: props.saturation },
+      uMouseRepulsion: { value: props.mouseRepulsion },
+      uTwinkleIntensity: { value: props.twinkleIntensity },
+      uRotationSpeed: { value: props.rotationSpeed },
+      uRepulsionStrength: { value: props.repulsionStrength },
+      uMouseActiveFactor: { value: 0.0 },
+      uAutoCenterRepulsion: { value: props.autoCenterRepulsion },
+      uTransparent: { value: props.transparent }
+    }
+  });
+
+  const mesh = new Mesh(gl, { geometry, program });
+  let animateId: number;
+
+  function update(t: number) {
+    animateId = requestAnimationFrame(update);
+    if (!props.disableAnimation) {
+      program.uniforms.uTime.value = t * 0.001;
+      program.uniforms.uStarSpeed.value = (t * 0.001 * props.starSpeed) / 10.0;
+    }
+
+    const lerpFactor = 0.05;
+    smoothMousePos.value.x += (targetMousePos.value.x - smoothMousePos.value.x) * lerpFactor;
+    smoothMousePos.value.y += (targetMousePos.value.y - smoothMousePos.value.y) * lerpFactor;
+
+    smoothMouseActive.value += (targetMouseActive.value - smoothMouseActive.value) * lerpFactor;
+
+    program.uniforms.uMouse.value[0] = smoothMousePos.value.x;
+    program.uniforms.uMouse.value[1] = smoothMousePos.value.y;
+    program.uniforms.uMouseActiveFactor.value = smoothMouseActive.value;
+
+    renderer.render({ scene: mesh });
+  }
+  animateId = requestAnimationFrame(update);
+  ctn.appendChild(gl.canvas);
+
+  function handleMouseMove(e: MouseEvent) {
+    const rect = ctn.getBoundingClientRect();
+    const x = (e.clientX - rect.left) / rect.width;
+    const y = 1.0 - (e.clientY - rect.top) / rect.height;
+    targetMousePos.value = { x, y };
+    targetMouseActive.value = 1.0;
+  }
+
+  function handleMouseLeave() {
+    targetMouseActive.value = 0.0;
+  }
+
+  if (props.mouseInteraction) {
+    ctn.addEventListener('mousemove', handleMouseMove);
+    ctn.addEventListener('mouseleave', handleMouseLeave);
+  }
+
+  cleanup = () => {
+    cancelAnimationFrame(animateId);
+    window.removeEventListener('resize', resize);
+    if (props.mouseInteraction) {
+      ctn.removeEventListener('mousemove', handleMouseMove);
+      ctn.removeEventListener('mouseleave', handleMouseLeave);
+    }
+    ctn.removeChild(gl.canvas);
+    gl.getExtension('WEBGL_lose_context')?.loseContext();
+  };
+};
+
+onMounted(() => {
+  cleanup?.();
+  setup();
+});
+
+onUnmounted(() => {
+  cleanup?.();
+});
+
+watch(
+  () => props,
+  () => {
+    cleanup?.();
+    setup();
+  },
+  { deep: true }
+);
+</script>
+
+<template>
+  <div ref="ctnDom" class="relative w-full h-full" v-bind="$attrs" />
+</template>
diff --git a/src/demo/Backgrounds/GalaxyDemo.vue b/src/demo/Backgrounds/GalaxyDemo.vue
new file mode 100644
index 0000000..975344b
--- /dev/null
+++ b/src/demo/Backgrounds/GalaxyDemo.vue
@@ -0,0 +1,182 @@
+<template>
+  <TabbedLayout>
+    <template #preview>
+      <div class="relative p-0 h-[600px] overflow-hidden demo-container">
+        <Galaxy
+          :density="density"
+          :glow-intensity="glowIntensity"
+          :saturation="saturation"
+          :hue-shift="hueShift"
+          :twinkle-intensity="twinkleIntensity"
+          :rotation-speed="rotationSpeed"
+          :repulsion-strength="repulsionStrength"
+          :auto-center-repulsion="autoCenterRepulsion"
+          :star-speed="starSpeed"
+          :speed="speed"
+          :mouse-repulsion="mouseRepulsion"
+          :mouse-interaction="mouseInteraction"
+        />
+        <BackgroundContent pill-text="New Background" headline="Components you shall have, young padawan." />
+      </div>
+
+      <Customize>
+        <PreviewSwitch title="Mouse Interaction" v-model="mouseInteraction" />
+        <PreviewSwitch title="Mouse Repulsion" v-model="mouseRepulsion" />
+        <PreviewSlider :min="0.1" :max="3" :step="0.1" v-model="density" title="Density" />
+        <PreviewSlider :min="0" :max="1" :step="0.1" v-model="glowIntensity" title="Glow Intensity" />
+        <PreviewSlider :min="0" :max="1" :step="0.1" v-model="saturation" title="Saturation" />
+        <PreviewSlider :min="0" :max="360" :step="10" v-model="hueShift" title="Hue Shift" value-unit="°" />
+        <PreviewSlider :min="0" :max="1" :step="0.1" v-model="twinkleIntensity" title="Twinkle Intensity" />
+        <PreviewSlider :min="0" :max="0.5" :step="0.05" v-model="rotationSpeed" title="Rotation Speed" />
+        <PreviewSlider :min="0" :max="10" :step="0.5" v-model="repulsionStrength" title="Repulsion Strength" />
+        <PreviewSlider :min="0" :max="20" :step="1" v-model="autoCenterRepulsion" title="Auto Center Repulsion" />
+        <PreviewSlider :min="0.1" :max="2" :step="0.1" v-model="starSpeed" title="Star Speed" />
+        <PreviewSlider :min="0.1" :max="3" :step="0.1" v-model="speed" title="Animation Speed" />
+      </Customize>
+
+      <PropTable :data="propData" />
+      <Dependencies :dependency-list="['ogl']" />
+    </template>
+
+    <template #code>
+      <CodeExample :code-object="galaxy" />
+    </template>
+
+    <template #cli>
+      <CliInstallation :command="galaxy.cli" />
+    </template>
+  </TabbedLayout>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import CliInstallation from '../../components/code/CliInstallation.vue';
+import CodeExample from '../../components/code/CodeExample.vue';
+import Dependencies from '../../components/code/Dependencies.vue';
+import BackgroundContent from '../../components/common/BackgroundContent.vue';
+import Customize from '../../components/common/Customize.vue';
+import PreviewSlider from '../../components/common/PreviewSlider.vue';
+import PreviewSwitch from '../../components/common/PreviewSwitch.vue';
+import PropTable from '../../components/common/PropTable.vue';
+import TabbedLayout from '../../components/common/TabbedLayout.vue';
+import { galaxy } from '../../constants/code/Backgrounds/galaxyCode';
+import Galaxy from '../../content/Backgrounds/Galaxy/Galaxy.vue';
+
+const density = ref(1);
+const glowIntensity = ref(0.3);
+const saturation = ref(0.0);
+const hueShift = ref(140);
+const twinkleIntensity = ref(0.3);
+const rotationSpeed = ref(0.1);
+const repulsionStrength = ref(2);
+const autoCenterRepulsion = ref(0);
+const starSpeed = ref(0.5);
+const speed = ref(1.0);
+const mouseRepulsion = ref(true);
+const mouseInteraction = ref(true);
+
+const propData = [
+  {
+    name: 'focal',
+    type: '[number, number]',
+    default: '[0.5, 0.5]',
+    description: 'Sets the focal point of the galaxy effect as [x, y] coordinates from 0 to 1'
+  },
+  {
+    name: 'rotation',
+    type: '[number, number]',
+    default: '[1.0, 0.0]',
+    description: 'Controls the rotation matrix of the galaxy as [x, y] rotation values'
+  },
+  {
+    name: 'starSpeed',
+    type: 'number',
+    default: '0.5',
+    description: 'Controls the speed of star movement and animation'
+  },
+  {
+    name: 'density',
+    type: 'number',
+    default: '1',
+    description: 'Controls the density of stars in the galaxy'
+  },
+  {
+    name: 'hueShift',
+    type: 'number',
+    default: '140',
+    description: 'Shifts the hue of all stars by the specified degrees (0-360)'
+  },
+  {
+    name: 'disableAnimation',
+    type: 'boolean',
+    default: 'false',
+    description: 'When true, stops all time-based animations'
+  },
+  {
+    name: 'speed',
+    type: 'number',
+    default: '1.0',
+    description: 'Global speed multiplier for all animations'
+  },
+  {
+    name: 'mouseInteraction',
+    type: 'boolean',
+    default: 'true',
+    description: 'Enables or disables mouse interaction with the galaxy'
+  },
+  {
+    name: 'glowIntensity',
+    type: 'number',
+    default: '0.3',
+    description: 'Controls the intensity of the star glow effect'
+  },
+  {
+    name: 'saturation',
+    type: 'number',
+    default: '0.0',
+    description: 'Controls color saturation of stars (0 = grayscale, 1 = full color)'
+  },
+  {
+    name: 'mouseRepulsion',
+    type: 'boolean',
+    default: 'true',
+    description: 'When true, stars are repelled by the mouse cursor'
+  },
+  {
+    name: 'twinkleIntensity',
+    type: 'number',
+    default: '0.3',
+    description: 'Controls how much stars twinkle (0 = no twinkle, 1 = maximum twinkle)'
+  },
+  {
+    name: 'rotationSpeed',
+    type: 'number',
+    default: '0.1',
+    description: 'Speed of automatic galaxy rotation'
+  },
+  {
+    name: 'repulsionStrength',
+    type: 'number',
+    default: '2',
+    description: 'Strength of mouse repulsion effect when mouseRepulsion is enabled'
+  },
+  {
+    name: 'autoCenterRepulsion',
+    type: 'number',
+    default: '0',
+    description: 'Creates repulsion from center of canvas. Overrides mouse repulsion when > 0'
+  },
+  {
+    name: 'transparent',
+    type: 'boolean',
+    default: 'true',
+    description: 'Makes the black background transparent, showing only stars'
+  }
+];
+</script>
+
+<style scoped>
+.demo-container {
+  padding: 0;
+}
+</style>