{"id":34693057,"url":"https://github.com/deadronos/vibe-aquarium-sim","last_synced_at":"2026-05-10T16:08:54.983Z","repository":{"id":324946081,"uuid":"1099188039","full_name":"deadronos/vibe-aquarium-sim","owner":"deadronos","description":"A relaxing, physics-driven aquarium simulation built with React, Three.js and Rapier physics — designed as a high-performance, ECS-driven interactive demo.","archived":false,"fork":false,"pushed_at":"2026-03-23T16:16:51.000Z","size":16693,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-23T16:46:28.378Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://deadronos.github.io/vibe-aquarium-sim/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deadronos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-18T17:20:28.000Z","updated_at":"2026-03-23T16:14:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/deadronos/vibe-aquarium-sim","commit_stats":null,"previous_names":["deadronos/vibe-aquarium-sim"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/deadronos/vibe-aquarium-sim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fvibe-aquarium-sim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fvibe-aquarium-sim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fvibe-aquarium-sim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fvibe-aquarium-sim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deadronos","download_url":"https://codeload.github.com/deadronos/vibe-aquarium-sim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deadronos%2Fvibe-aquarium-sim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-24T22:04:32.875Z","updated_at":"2026-04-02T00:06:42.031Z","avatar_url":"https://github.com/deadronos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vibe Aquarium Sim\n\nA relaxing, physics-driven aquarium simulation built with React, Three.js and Rapier physics — designed as a high-performance, ECS-driven interactive demo.\n\nModels were generated with experimental Copilot 3D:\n(https://copilot.microsoft.com/labs/experiments/3d-generations)\n\nLive demo: [deadronos.github.io/vibe-aquarium-sim](https://deadronos.github.io/vibe-aquarium-sim/)\nImage: ![vibe aquarium screenshot](./image.png)\n\nKey ideas:\n\n- Physics is the source of truth — rigid bodies in Rapier govern movement and collisions.\n- ECS architecture (Miniplex) separates simulation logic (systems) from render/physics representations (components).\n- Vite + React (R3F) + TypeScript for fast iteration and strong developer ergonomics.\n\nTech stack\n\n- React 19 + TypeScript\n- Vite (build tooling)\n- Three.js + @react-three/fiber for rendering\n- @react-three/rapier (Rapier) for physics\n- miniplex + miniplex-react for ECS\n\nRepository layout (high-level)\n\n- src/\n  - components/: R3F components + physics wrappers (Fish, Tank, Water)\n  - systems/: ECS systems (Boids, WaterResistance, Scheduler)\n  - store.ts: ECS world and entity definitions\n  - shaders/: custom water shader\n  - config/: shared physics configuration\n\n- public/: static assets\n- tests/: unit / integration tests\n\nGetting started\n\nPrerequisites\n\n- Node.js 20+ (this project uses modern toolchains)\n\nInstall\n\n```bash\nnpm ci\n```\n\nRun locally\n\n```bash\nnpm run dev\n```\n\nBuild\n\n```bash\nnpm run build\n```\n\nPreview production build\n\n```bash\nnpm run preview\n```\n\nTests \u0026 formatting\n\n```bash\nnpm run test        # run tests\nnpm run lint        # ESLint\nnpm run format      # Prettier\n```\n\nDevelopment notes \u0026 patterns\n\n- Performance: avoid allocating new Vector3/Matrix objects inside render loops. Look for module-level temporary vectors in systems and components.\n- Physics-driven movement: systems compute desired velocities/impulses, apply them to Rapier rigid bodies, and `Fish.tsx` syncs back Rapier state into ECS.\n- Query ECS with `world.with(...)` and keep systems focused and fast.\n\nImportant files / starting points\n\n- `src/store.ts` — ECS world + entity types\n- `src/components/Fish.tsx` — R3F + Rapier integration and ECS sync\n- `src/systems/BoidsSystem.tsx` — swarm-like behavior logic\n- `src/systems/WaterResistanceSystem.tsx` — simple fluid drag forces\n- `src/utils/FixedStepScheduler.ts` — fixed-step simulation helper\n\nGitHub Actions / Deployment\n\n- Pages workflow: `.github/workflows/deploy-pages.yml` builds the app and deploys the `dist/` output to GitHub Pages using current action versions (checkout@v6, setup-node@v6, upload-pages-artifact@v4, deploy-pages@v4).\n- Vite `base`: this repo is configured for the project Pages URL `https://deadronos.github.io/vibe-aquarium-sim/` — `base` is set to `/vibe-aquarium-sim/` in `vite.config.ts` and CI passes `--base /vibe-aquarium-sim/` when building.\n\nContributing\n\n- Read .github/instructions/\\* and memory/ to get the project's conventions and design history.\n- Keep changes small, test-driven and avoid allocations in render loops.\n\nLicense \u0026 attribution\n\n- Check the repository root for license and contributor information.\n\nQuestions / next steps\n\n- Want a PR preview workflow (deploy a preview for PRs) or CI optimization (caching and faster builds)? Open an issue or start a draft PR.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadronos%2Fvibe-aquarium-sim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeadronos%2Fvibe-aquarium-sim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeadronos%2Fvibe-aquarium-sim/lists"}