Skip to content

OpenPhysics/LadyBug

Lady Bug

A SceneryStack port of the PhET Ladybug Motion 2D simulation. Explore 2D motion, position, velocity, and acceleration using a ladybug on a rotating platform.

Features

  • Single-screen kinematics simulation on a rotatable platform
  • Drag the ladybug and observe position, velocity, and acceleration vectors
  • Default and projector color profiles
  • English and French localization
  • Progressive Web App with GitHub Pages deployment via GitHub Actions

Quick Start

npm install
npm run icons    # generate PNG icons from public/icons/icon.svg
npm start        # dev server → http://localhost:5173

Scripts

Command Description
npm start / npm run dev Start Vite dev server
npm run build Type-check + production build → dist/
npm run preview Preview the production build locally
npm run check TypeScript type check
npm run lint Biome lint check
npm run format Auto-format all files
npm run fix Lint + auto-fix
npm run icons Regenerate PNG icons from public/icons/icon.svg
npm run clean Remove dist/

Tech Stack

Tool Version Purpose
SceneryStack ^3.0.0 Simulation framework
Vite ^8 Build tool + dev server
TypeScript ^6 Type-safe JavaScript
Biome ^2.4 Linting + formatting
vite-plugin-pwa ^1 PWA + service worker

License

GNU Affero General Public License v3.0 — see OpenPhysics org license. The original PhET simulation is Copyright © University of Colorado; this is an independent reimplementation.

Contributing

See OpenPhysics contributing guidelines. Report bugs via GitHub Issues; use org issue templates.

About

SceneryStack port of the PhET 'Ladybug Motion 2D' simulation. Explore 2D motion, position, velocity, and acceleration using a ladybug on a rotating platform.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors