Skip to content
VibeFather
Sign up free

About this template

An interactive astrophysics explainer opening immediately on a real-time GLSL ray-marched black hole with gravitational lensing, a Doppler-beamed orange-gold accretion disk, sharp photon ring, and drag-to-orbit controls. Scroll through six hands-on chapters covering the Event Horizon, Photon Sphere light-ray bending, an interactive Time-Dilation Dual Clocks laboratory, Tidal Spaghettification stretching, an Earth-sized VLBI Virtual Telescope baseline simulator, and a logarithmic Stellar-to-Supermassive size comparator—all clearly labelled as simplified educational relativistic physics.

The template prompt

The live demo was built from exactly this text — nothing added.

# Black Hole Interactive Explainer

Build this website exactly as described below. Replace the [VARIABLES] with your own values; keep everything else.

## Brief
Build an interactive astrophysics explainer for [OBSERVATORY_NAME] showcasing rotating black hole specimen [OBJECT_NAME] ([MASS_LABEL], [DISTANCE_LABEL]). Frame 1 opens directly on a real-time GLSL ray-marched Three.js black hole rendered in deep cosmic black (#050508) with hot disk orange (#FF8A2A), incandescent gold (#FFD27A), and cool starlight blue (#9DB8FF). Visitors can orbit 360° around the gravitationally lensed accretion disk, toggle Doppler beaming, adjust inclination presets and plasma glow, and then scroll through six interactive chapters: (01) Event Horizon escape-velocity probe, (02) Photon Sphere curved light-ray impact-parameter lab, (03) Time Dilation Dual Clocks comparing distant observer vs infalling traveler clocks as radius r/rs approaches 1.01, (04) Tidal Spaghettification gradient simulator comparing stellar vs supermassive horizons, (05) Earth-sized VLBI Virtual Telescope linking 7 global radio dishes to sharpen a live synthetic shadow ring, and (06) Stellar-to-Supermassive cosmic size comparator. Clearly label all models as simplified educational physics and keep zero calendar dates or 4-digit years on the frontend.

- Audience: Curious readers, physics students, educators, and astronomy enthusiasts.
- Goal: Turn general relativity concepts—gravitational lensing, relativistic time dilation, tidal stretching, and Earth-scale interferometry—into immediate visual and tactile intuition.
- Tone: Awe-inspired scientific clarity—precise observatory instrumentation paired with lucid plain-English explanations.

## Stack
- Framework: Vite 6 + React 18 + TypeScript
- Styling: Tailwind CSS 4
- Libraries: three (MIT), @types/three (MIT), lucide-react (ISC), @fontsource/space-grotesk (OFL-1.1), @fontsource/inter (OFL-1.1), @fontsource/jetbrains-mono (OFL-1.1)
- Build: `npm run build` → static files in `dist/`. No backend, no server code, no external APIs.
- Setup:
  - Set base: './' and build: { sourcemap: false } in vite.config.ts.
  - Import @fontsource/space-grotesk (500, 600, 700), @fontsource/inter (400, 500, 600), and @fontsource/jetbrains-mono (400, 500, 600) in src/main.tsx.
  - Render the real-time ray-marched gravitational-lensing black hole in a full-viewport-width Three.js ShaderMaterial canvas (preserveDrawingBuffer: true) that renders frame 1 synchronously before RAF.
  - Keep all 6 interactive relativity chapters and data in src/data/blackHoleData.ts and modular interactive widgets in src/components/RelativityLabs.tsx.

## Variables
- [OBSERVATORY_NAME] — Publication Name (default: "Event Horizon Atlas"). Name of the interactive science publication
- [OBJECT_NAME] — Featured Specimen (default: "Aurelia-X1"). Catalog designation of the featured black hole
- [MASS_LABEL] — Featured Mass (default: "6.5 Billion Solar Masses"). Mass label displayed in hero telemetry
- [DISTANCE_LABEL] — Distance Readout (default: "55 Million Light-Years"). Distance label displayed in hero telemetry
- [CREDIT] — keep a small "Template by VibeFather" link to https://vibefather.ai/t/black-hole-interactive-explainer in the footer (default: yes; delete this line to remove it)

The copy under Pages & Sections is written for the default values. If your values differ, rewrite every headline, paragraph, label and image for them — same length, tone and structure. Layout, colors, type and motion stay as described.
Keep all copy, image paths and links in one content file (for example `src/content.ts`), keyed by section, so the content can be swapped later without touching components.

## Design
### Colors
- Deep Space `#050508` — Primary background canvas
- Obsidian Instrument `#0E1019` — Lab cards and telemetry panels
- Hot Disk Orange `#FF8A2A` — Accretion plasma and primary interactive accent
- Incandescent Gold `#FFD27A` — Innermost stable orbit photon ring highlight
- Cool Starlight Blue `#9DB8FF` — Relativistic Doppler approach shift and data metrics

### Typography
- Display Title & Chapter Headings: Space Grotesk (OFL), weights 500/600/700
- Explanatory Prose: Inter (OFL), weights 400/500/600
- Equations, Clocks & Telemetry: JetBrains Mono (OFL), weights 400/500/600

### Layout & motion
- Spacing: Full-bleed interactive ray-marched WebGL hero with docked glass HUD, followed by centered 1152px max-width alternating chapter sections with generous vertical rhythm.
- Radius: 16px precision obsidian instrument panels with 1px starlight-tinted borders.
- Motion: Continuous real-time ray-marched swirling accretion plasma and relativistic Doppler glow with 360° drag orbit.
- Motion: Live ticking dual clocks driven by gravitational time dilation sqrt(1 - rs/r).
- Motion: Smooth interactive sliders for light-ray impact parameter, infall tidal gradient, VLBI dish toggling, and cosmic mass scale.
- Motion: Respect prefers-reduced-motion by pausing auto-orbit rotation while keeping drag orbit and all lab sliders fully responsive.
- Imagery: 100% procedural GLSL fragment shader black hole, starfield, and code-drawn interactive SVG/Canvas physics instruments.

## Pages & Sections
### [OBSERVATORY_NAME] · Black Hole Interactive Explainer (`#/explainer`)
1. **Frame-1 Ray-Marched Black Hole Hero** — Immediate full-beauty gravitationally lensed black hole [OBJECT_NAME] ([MASS_LABEL], [DISTANCE_LABEL]) with glowing orange-gold accretion disk arching over and beneath the shadow, bright photon ring, subtle Doppler beaming, and starfield. Includes drag-to-orbit hint, preset camera angles (Lensed Overlook, Edge-On Disk, Polar View), Spin/Doppler toggle, Disk Glow slider, Auto-Orbit toggle, chapter jump nav, and a clear 'Simplified educational physics model' badge.
   Layout: Full-bleed dark cosmic hero stage (min-h-[680px] desktop, clean stacked HUD on 390px mobile) with zero splash delay.
   Motion: Real-time GLSL ray-marched geodesic bending and plasma turbulence.
2. **Six Interactive Relativity Chapters** — (01) Event Horizon escape-velocity probe showing escape speed crossing c at r = rs; (02) Photon Sphere & Lensing interactive impact-parameter ray bender; (03) Time-Dilation Dual Clocks with live distant vs traveler clocks and r/rs slider; (04) Tidal Forces & Spaghettification comparing 10 M☉ stellar vs 6.5B M☉ supermassive stretching; (05) Earth-Sized VLBI Virtual Telescope with 7 toggleable radio stations updating baseline coverage and live shadow sharpness; (06) Stellar-to-Supermassive Cosmic Scale comparator against recognizable solar-system landmarks.
   Layout: Asymmetric 12-column cards pairing concise plain-English astrophysics copy with tactile interactive SVG/Canvas lab instruments.
   Motion: Responsive real-time vector updates and live relativistic clock hands.

## Assets
- font: Install @fontsource/space-grotesk, @fontsource/inter, and @fontsource/jetbrains-mono via npm.

## Don'ts
- Never show a black empty first frame or loading gate before the ray-marched black hole appears.
- Never present simplified physics approximations without clearly labelling them as simplified educational models.
- Never include calendar dates or 4-digit years anywhere on the frontend.
- Never fetch external images or CDN fonts.

---
— Prompt by VibeFather · https://vibefather.ai/t/black-hole-interactive-explainer · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown

Free for personal projects under CC BY-NC 4.0. Commercial use comes with Pro.

DESIGN.md

The design system on its own — colors, type, spacing and motion. Apply this look to a project you already have.

---
name: "Black Hole Interactive Explainer"
colors:
  deep_space: "#050508"
  obsidian_instrument: "#0E1019"
  hot_disk_orange: "#FF8A2A"
  incandescent_gold: "#FFD27A"
  cool_starlight_blue: "#9DB8FF"
typography:
  display_title_chapter_headings: { family: "Space Grotesk", weights: [500, 600, 700] }
  explanatory_prose: { family: "Inter", weights: [400, 500, 600] }
  equations_clocks_telemetry: { family: "JetBrains Mono", weights: [400, 500, 600] }
spacing: "Full-bleed interactive ray-marched WebGL hero with docked glass HUD, followed by centered 1152px max-width alternating chapter sections with generous vertical rhythm."
radius: "16px precision obsidian instrument panels with 1px starlight-tinted borders."
---

# Black Hole Interactive Explainer — Design System

Apply this design system to an existing project. It describes the look and feel only; for the full site, use prompt.md.

## Colors
- **Deep Space** `#050508` — Primary background canvas
- **Obsidian Instrument** `#0E1019` — Lab cards and telemetry panels
- **Hot Disk Orange** `#FF8A2A` — Accretion plasma and primary interactive accent
- **Incandescent Gold** `#FFD27A` — Innermost stable orbit photon ring highlight
- **Cool Starlight Blue** `#9DB8FF` — Relativistic Doppler approach shift and data metrics

## Typography
- **Display Title & Chapter Headings** — Space Grotesk (OFL), weights 500/600/700. Self-host the font files.
- **Explanatory Prose** — Inter (OFL), weights 400/500/600. Self-host the font files.
- **Equations, Clocks & Telemetry** — JetBrains Mono (OFL), weights 400/500/600. Self-host the font files.

## Spacing & shape
- Spacing: Full-bleed interactive ray-marched WebGL hero with docked glass HUD, followed by centered 1152px max-width alternating chapter sections with generous vertical rhythm.
- Radius: 16px precision obsidian instrument panels with 1px starlight-tinted borders.

## Motion
- Continuous real-time ray-marched swirling accretion plasma and relativistic Doppler glow with 360° drag orbit.
- Live ticking dual clocks driven by gravitational time dilation sqrt(1 - rs/r).
- Smooth interactive sliders for light-ray impact parameter, infall tidal gradient, VLBI dish toggling, and cosmic mass scale.
- Respect prefers-reduced-motion by pausing auto-orbit rotation while keeping drag orbit and all lab sliders fully responsive.

## Imagery
100% procedural GLSL fragment shader black hole, starfield, and code-drawn interactive SVG/Canvas physics instruments.

## Tone
Awe-inspired scientific clarity—precise observatory instrumentation paired with lucid plain-English explanations.

---
— Prompt by VibeFather · https://vibefather.ai/t/black-hole-interactive-explainer · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown

Make it yours

  • A university physics department: set [OBSERVATORY_NAME] to your lab or course name, [OBJECT_NAME] to a real catalog object, and rewrite the chapter copy for your syllabus.
  • A planetarium or science museum: keep the ray-marched hero as the kiosk opening, set [OBJECT_NAME] to your show's subject, and point the chapter jump nav at your exhibit stops.
  • An astronomy YouTuber or newsletter writer: use the template as a companion page for an episode, with [OBJECT_NAME] and [MASS_LABEL] matching the video and the VLBI lab as the interactive extra.
  • A student portfolio or coursework project: keep the six chapters, set [OBSERVATORY_NAME] to your name, and swap the cosmic scale landmarks for examples you explain in your own words.

Black Hole Interactive Explainer: questions and answers

How do I change the black hole, observatory name and distance in the Black Hole Interactive Explainer?

The Black Hole Interactive Explainer template uses four variables: [OBSERVATORY_NAME] for the publication name, [OBJECT_NAME] for the featured specimen, [MASS_LABEL] for the hero mass readout and [DISTANCE_LABEL] for the distance. Set them in the content file the prompt asks for, then rewrite every headline, paragraph and label that mentions the default values so the copy stays consistent with your own object.

What do the six interactive chapters in the Black Hole Interactive Explainer cover?

The Black Hole Interactive Explainer walks through six chapters: an Event Horizon escape-velocity probe, a Photon Sphere impact-parameter lab for curved light rays, a Time-Dilation Dual Clocks laboratory comparing distant and infalling observers, a Tidal Spaghettification simulator, an Earth-sized VLBI Virtual Telescope with 7 toggleable radio dishes, and a Stellar-to-Supermassive cosmic size comparator. Each chapter pairs plain-English physics copy with an SVG or Canvas instrument you can drag or slide.

Is there a free interactive black hole website template I can build with AI?

Yes. The Black Hole Interactive Explainer is a free template on VibeFather, and its prompt and DESIGN.md are free for personal, non-commercial use under CC BY-NC 4.0. Commercial or client use needs a Pro license. You can run the prompt in an AI coding agent such as Claude Code, Codex, Cursor or Gemini CLI, or add the template with the npx vibefather add black-hole-interactive-explainer command.

How does the Time-Dilation Dual Clocks lab work in this black hole explainer?

The Time-Dilation Dual Clocks lab in the Black Hole Interactive Explainer shows two live clocks: one for a distant observer and one for an infalling traveler. A slider moves the traveler's radius toward r/rs = 1.01, and the clock rates follow the gravitational time dilation factor sqrt(1 - rs/r), so the traveler's clock visibly slows as it nears the horizon. The prompt labels the model as simplified educational physics.

Can I use the Black Hole Interactive Explainer to teach general relativity in a classroom?

The Black Hole Interactive Explainer suits physics students, educators and curious readers. Its chapters turn gravitational lensing, time dilation, tidal stretching and Earth-scale interferometry into visual instruments you can drag, and every model is labelled as simplified educational physics. The template is one page with a full-bleed WebGL hero and a stacked HUD on mobile, so it reads on a projector or a phone, and prefers-reduced-motion pauses the auto-orbit while drag controls stay active.

How do I build a black hole interactive explainer with AI?

Copy the prompt from this page or run npx vibefather add black-hole-interactive-explainer, replace the variables with your own content, and paste it into Claude Code, Codex, Cursor or another AI coding agent. The live demo was built from exactly that text.

Which AI model built the Black Hole Interactive Explainer demo?

The Event Horizon Atlas (Aurelia-X1) case was built by Gemini 4 Neon in Antigravity. Each build used the published prompt with nothing added.

What tech stack and pages does the Black Hole Interactive Explainer template use?

Black Hole Interactive Explainer is a single-page site built with Three.js, React, Tailwind CSS and Webgl, with scroll animation and 3d / webgl. The prompt fixes the stack so every AI tool builds the same kind of project, and the result runs as a static site you can host anywhere.

Can I use the Black Hole Interactive Explainer template for a client or a business?

The Black Hole Interactive Explainer prompt and DESIGN.md are free for personal, non-commercial projects under CC BY-NC 4.0. Client work and commercial use need VibeFather Pro, which also includes the source code of the live demo.

Does the Black Hole Interactive Explainer template work on mobile?

Yes. Every Black Hole Interactive Explainer build was tested on a phone-sized screen as well as desktop before it went live, checking layout, text size and touch targets. Open the live demo on your phone, or switch the preview on this page to mobile view, to check it yourself.