whatisgithub

What is physics-atlas?

sac-y/physics-atlas — explained in plain English

Analysis updated 2026-05-18

9JavaScriptAudience · generalComplexity · 3/5Setup · easy

In one sentence

An interactive web app that visualizes 400 years of physics history as a navigable star galaxy, with playable simulations for major theories.

Mindmap

mindmap
  root((Physics Atlas))
    What it does
      History as a galaxy
      Theory lineage lines
      Playable simulations
    Tech stack
      Three.js
      GLSL shaders
      Vite
      KaTeX
    Use cases
      Explore physics history
      Run simulations
      Guided tours
    Audience
      Students
      Science enthusiasts
    Views
      Galaxy mode
      Timeline mode
      Scale mode

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore how major physics theories connect and influenced one another over four centuries.

USE CASE 2

Run interactive simulations of gravity, Newton's laws, electromagnetism, entropy, and relativity.

USE CASE 3

Switch between a galaxy view, a timeline view, and a scale view of physics history.

USE CASE 4

Follow guided tour routes that walk through specific physics storylines like the nature of light.

What is it built with?

JavaScriptThree.jsGLSLViteKaTeXCanvas

How does it compare?

sac-y/physics-atlasabivan-tech/zvec-mcpardupilot/dronecan-webtools
Stars999
LanguageJavaScriptJavaScriptJavaScript
Last pushed2025-09-02
MaintenanceQuiet
Setup difficultyeasymoderatemoderate
Complexity3/53/53/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Also available as a hosted online demo, so no local setup is required just to try it.

No license is stated in the README, so usage rights are unclear.

So what is it?

Physics Star Atlas turns four hundred years of physics history into a galaxy you can fly through in your web browser. Every physics theory is shown as a star, and lines between stars show who built on whose ideas, so you can trace how one discovery led to the next. You zoom and pan around the whole starfield, and clicking any star opens a hands on, real time simulation that teaches that theory. The galaxy contains 760 objects in total: 160 stars that each have a full profile covering a major theory, plus 600 smaller background stars representing lesser results. Six scientific subjects each form their own colored nebula, and 330 connecting lines map out this network of who influenced whom. Zooming works in four steps, starting with a wide view of the subject areas, moving closer to reveal star names and their connecting lines, and finally opening a detailed profile card for a single theory, all with smooth, gradual motion rather than sudden jumps. Seven interactive teaching stations, called deep space labs in the README, each walk through a step by step lesson built around one designed moment meant to surprise the learner. The topics covered are gravity, shown by flinging a planet into an elliptical orbit, Newton's laws of motion, Maxwell's electromagnetic field, the increase of entropy shown through reversed time, the double slit experiment sending one photon at a time, a light clock illustrating special relativity, and Faraday's law of electromagnetic induction. You can also switch between three ways of viewing the same data: as a galaxy, as a timeline laid out by year, or by physical scale from tiny particles up to the whole universe, with the display smoothly rearranging as you switch. Hovering a star highlights everything connected to it, clicking a subject label focuses on that whole field, and a search box lets you jump straight to a law or scientist by name. Three guided tour routes walk newcomers through specific storylines, such as what light is or how ideas moved from falling objects to black holes. The project is built with the Three.js graphics library and custom shaders, uses Vite to build the app and KaTeX to typeset equations, and each mini simulation is written as its own self contained module. To run it locally you install dependencies with npm and start a development server with one command.

Copy-paste prompts

Prompt 1
Explain how the star and lineage system in this app represents the history of physics.
Prompt 2
Walk me through running this project locally with npm.
Prompt 3
Describe what each of the seven interactive physics simulations demonstrates.
Prompt 4
Explain the difference between the galaxy, timeline, and scale viewing modes.

Frequently asked questions

What is physics-atlas?

An interactive web app that visualizes 400 years of physics history as a navigable star galaxy, with playable simulations for major theories.

What language is physics-atlas written in?

Mainly JavaScript. The stack also includes JavaScript, Three.js, GLSL.

What license does physics-atlas use?

No license is stated in the README, so usage rights are unclear.

How hard is physics-atlas to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is physics-atlas for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.